快速开始
接口完全兼容 OpenAI 协议。如果你已有现成代码,只需要改一个 base_url。
三步接入
1
登录控制台用管理员分配的账号登录 /login。
2
创建令牌进入「令牌管理」新建密钥,建议按环境(测试/生产)分开创建,便于单独吊销。
3
发起调用把
base_url 换成下面的地址,用你的密钥替换 YOUR_KEY。Base URL
https://www.qianbaotoken.com/v1
地址末尾的
/v1 需要保留,SDK 里的 base_url 填到这里即可。
所有接口都基于这个地址,例如:{base}/chat/completions、{base}/models、{base}/videos。
获取密钥
- 登录后进入 令牌管理
- 点击「新建令牌」,填写名称,额度留空或按需设置
- 复制生成的密钥(只显示一次),保存到服务端环境变量
密钥等同于密码,不要写进前端代码、不要提交到 Git 仓库。怀疑泄露时立即在控制台禁用。
发起调用
下面是同一个请求的三种写法,任选一种:
curl https://www.qianbaotoken.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-flash",
"messages": [{"role": "user", "content": "你好"}],
"stream": true
}'
对话补全
POST {base}/chat/completions
| 参数 | 必填 | 说明 |
|---|---|---|
model | 是 | 模型 ID,见下方模型列表或 价格页 |
messages | 是 | 消息数组,支持 system / user / assistant |
stream | 否 | true 时以 SSE 流式返回 |
max_tokens | 否 | 限制输出长度 |
tools | 否 | 函数调用,透传给上游模型 |
模型列表
GET {base}/models —— 返回当前账号可用的全部模型 ID。
curl https://www.qianbaotoken.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
当前可用:28 个模型,覆盖 DeepSeek、Kimi、Qwen、GLM、Hunyuan、GPT、Claude 与豆包视频。
视频任务(异步)
视频与文本不同:创建成功 ≠ 生成完成,必须轮询任务状态。
1. 创建任务
curl https://www.qianbaotoken.com/v1/videos \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Doubao-Seedance-2.0-mini",
"prompt": "一只猫在沙滩上走",
"resolution": "480p",
"duration": 4
}'
# → {"id":"task_xxx","status":"queued"}
2. 轮询结果
curl https://www.qianbaotoken.com/v1/videos/task_xxx \
-H "Authorization: Bearer YOUR_KEY"
| 参数 | 必填 | 说明 |
|---|---|---|
resolution | 是 | 漏传会返回 Missing required parameter(s): resolution |
duration | 否 | 秒数,2.0 系列 4–15,2.5 为 4–30;不传按 5 秒计费 |
prompt | 是 | 画面描述 |
错误对照
| 返回 | 含义 | 处理 |
|---|---|---|
401 Invalid token | 密钥错误或已禁用 | 检查密钥是否完整、是否含多余空格;控制台确认状态为「启用」 |
400 价格尚未由管理员配置 | 该模型未定价 | 联系管理员,或换用其它模型 |
403 额度不足 | 余额不够本次调用 | 充值或联系管理员加额度 |
503 No available channel | 该模型暂时没有可用线路 | 稍后重试,或联系管理员 |
400 Missing required parameter | 缺必填参数(常见于视频) | 对照上方参数表补齐 |
| 200 但无内容 | 上游返回空 | 降低 max_tokens 或换模型重试 |
常见问题
支持哪些客户端?
所有支持「自定义 Base URL」的 OpenAI 兼容客户端都可以:Cherry Studio、Chatbox、LobeChat、Dify、LangChain、OpenAI 官方 SDK 等。
有并发限制吗?
不限制并发,实际吞吐取决于上游模型的处理能力。
额度怎么算?
按 token 计费:输入与输出分别计价,缓存命中的部分按更低单价计算。视频按生成秒数计费。详见 模型价格。
密钥可以在多个环境共用吗?
可以,但建议按环境分别创建,这样某个环境泄露时只需吊销那一个。
怎么开发票?
请联系客服提供开票信息。