技术文档

怎么接进来、报错怎么看、常见问题在哪 —— 三章讲完

用配置助手一键生成 →
① 快速上手 ② 错误码 ③ 常见问题

① 快速上手(三步)

1. 拿到 Key

登录控制台 → 顶部「接入」→ 复制你的 sk- 开头的 API Key。

2. 改地址

把客户端里的 base_url 换成下面这个地址。

3. 选模型

模型名用下面「可用模型」表里的名字,改名即可用。

接口地址

—
BASE URL —

所有请求都带这个头:Authorization: Bearer <你的 API Key>。 完全兼容 OpenAI 协议:只改 base_url 和 api_key,你的现有代码不用动。 自建服务器请把域名换成你自己的域名(如 https://api.你的域名.com/v1)。

本地演示说明:本项目跑的是「自研业务层」,/v1/models 已经生效; /v1/chat/completions 的转发由网关(New API)在部署时提供。

一个能直接跑的调用示例

把 Key 换成你自己的,整段复制到终端就能出结果。

—

成功时的返回长这样

—

可用模型

GET /v1/models
模型倍率 每百万 token 扣积分
加载中…

「倍率」是不同模型之间的换算关系,你不需要自己算 —— 实际用了多少积分, 登录控制台 →「用量」里逐条可查。

② 错误码

HTTP含义怎么处理
401Key 无效或未携带检查 Authorization: Bearer sk-...,或到控制台重置 Key
403账号被停用 / 无权限联系运营
404模型名不存在对着上面「可用模型」表核对模型名,注意大小写与连字符
429触发了日 / 周用量上限到控制台把日 / 周滑竿上调(可预支范围内),或购买应急加油包
402 / 400套餐额度已耗尽购买应急加油包,或等下月额度重置
5xx平台侧临时故障已自动重试并切换备用线路;持续失败请稍后重试或联系运营
额度不够时优先到控制台调 日 / 周滑竿 —— 只要还在本月总额度内就能先顶着用, 不用马上掏钱。真用满了再考虑加油包。

③ 常见问题

Q:报错 Connection error / 连不上?

先确认 base_url 结尾带 /v1,且没有多写或少写斜杠。

Q:返回「模型不存在」?

模型名要和上面「可用模型」表完全一致(claude-sonnet-5 这类带连字符的别写成空格)。

Q:我到底用了多少?在哪看?

登录控制台 →「用量」里有逐条明细,按模型、按时间都能看,不用自己算。

Q:返回 429,是不是余额没了?

不是。429 是撞到了日 / 周上限,本月总额度通常还有。到控制台把滑竿上调即可,或将模型换成更省的那档。

Q:流式输出怎么开?

请求体里加 "stream": true,服务端按 SSE 返回 data: {...} 分片,最后以 data: [DONE] 结束。

Q:额度什么时候重置?

每月 1 日 00:00(自然月)。加油包在有效期内单独计算,不受月度重置影响。

配置不想手写?打开 快速配置助手,点三下就能生成好可以直接粘贴的配置。 已经接进来了?登录控制台「用量」里逐条看你实际用了多少。