接口与 OpenAI Chat Completions 兼容。这一页同时挂在公开路径 /docs 和控制台里,内容相同。
请求头使用 Authorization: Bearer sk-...。密钥在控制台创建,完整内容只显示一次,数据库里只保存哈希和前缀。不要把密钥写进浏览器前端。
数字来自单价表。某个模型没有单独一行时,使用 default。
| 模型 | 输入 / 百万 Token | 输出 / 百万 Token |
|---|---|---|
| default(默认) | ¥1.00 | ¥2.00 |
余额单位是人民币。内部记账用微元,1 元等于 1,000,000 微元。
一次成功调用的费用 = 向上取整(输入 Token × 输入单价 + 输出 Token × 输出单价)÷ 1,000,000。上面表格里的金额就是每百万 Token 的人民币价格。不足 1 微元的部分会进到 1 微元。
模型有自己的单价行时用那一行,没有时用 default。default 不能删除。
只有上游成功返回后才扣费。密钥无效(401)、余额不足(402)、本月额度用尽(429,错误码 monthly_quota_exceeded)以及超过请求频率时,请求不会转发给上游,也不会计费。
如果请求已经成功,但扣费时余额不够支付全部费用,平台只扣掉当时剩余的余额。用量记录里会同时留下应付金额和实际扣除金额。
在线充值只使用 PayPal。在控制台账单页选择金额后,会跳到 PayPal 批准付款。PayPal 捕获完成之后,相同数字记入平台额度。
取消、未批准或捕获失败都不会改变余额。同一笔 PayPal 捕获只会入账一次,重复通知不会再次加额度。管理员仍然可以在后台发放、扣减或直接设定余额,这条路径不经过 PayPal。
未配置 PayPal 时,账单页不显示支付按钮,网站其余功能照常使用。到账记录会出现在账单的 PayPal 记录里,管理员的额度审计里也能看到类型为「PayPal 充值」的流水。
当前平台默认:每分钟 30 次,每天 2000 次,同时进行 2 个请求。密钥上的数字优先于用户上的数字,用户上的数字优先于这里的默认值。0 表示不限制,留空表示继承上一级。
每天的次数存在 MongoDB 里,容器重启后仍然有效。每分钟次数和同时请求数记在当前进程里,重启后重新计算。
在校验密钥之前,同一个 IP 每分钟最多 60 次请求,用来减慢试探密钥。登录和注册使用单独的次数限制。
超过限制时返回 429,并带上 Retry-After。成功和被拒绝的接口响应都会带上 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset,以及每日额度和 RateLimit 响应头。被限流的请求会记一条用量,费用为 0。
错误体是 JSON:error.message、error.type、error.code,并带上 error.request_id。
可以在请求头 X-Request-Id 里传入自己的编号。没有传入时平台会生成一个,并把它放进错误 JSON 和用量记录。