接入文档
我的令牌1. 基础信息
所有请求统一走 OpenAI 兼容协议,把 base_url 指向本站网关即可。网关会自动完成渠道路由、限流、计费与日志记录。
-
- 接口前缀:
/v1· 鉴权方式:Authorization: Bearer sk-xxx - 也支持
x-api-key与api-key请求头 - 兼容端点:
/v1/chat/completions、/v1/messages(Claude)、/v1/embeddings、/v1/models
2. 代码示例
from openai import OpenAI client = OpenAI( api_key="sk-你的令牌", base_url="BASE_URL/v1" ) resp = client.chat.completions.create( model="gpt-4o-mini", messages=[ {"role": "system", "content": "你是一个 helpful 助手"}, {"role": "user", "content": "用一句话介绍你自己"} ], stream=True ) for chunk in resp: print(chunk.choices[0].delta.content or "", end="")
import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-你的令牌", baseURL: "BASE_URL/v1" }); const stream = await client.chat.completions.create({ model: "gpt-4o-mini", messages: [{ role: "user", content: "你好" }], stream: true }); for await (const part of stream) { process.stdout.write(part.choices[0]?.delta?.content ?? ""); }
curl BASE_URL/v1/chat/completions \ -H "Authorization: Bearer sk-你的令牌" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "你好"}], "stream": false }'
from anthropic import Anthropic client = Anthropic( api_key="sk-你的令牌", base_url="BASE_URL" ) msg = client.messages.create( model="claude-sonnet-4-5", max_tokens=1024, messages=[{"role": "user", "content": "你好"}] )
3. 查余额与用量
curl BASE_URL/api/usage/token \
-H "Authorization: Bearer sk-你的令牌"
返回剩余配额、已用配额、今日请求数与当前分组倍率。
4. 计费规则
- 费用 = (输入 Token × 输入单价 + 输出 Token × 输出单价 + 缓存读 × 缓存读价 + 缓存写 × 缓存写价) × 模型倍率 × 分组倍率
- 请求发起时按估算值预扣,响应返回后按上游真实 usage 结算,多扣部分自动退回,失败请求全额退款
- 缓存命中(cached_tokens)按缓存价计费,比普通输入便宜
- 每个模型也可配置按次计费(perCall),适用于绘图等非 Token 类接口
5. 限流与错误码
| HTTP | code | 说明 |
|---|---|---|
| 401 | token_not_found | 令牌不存在 |
| 401 | token_disabled | 令牌已禁用 |
| 401 | token_expired | 令牌已过期 |
| 401 | model_not_allowed | 令牌无权访问该模型 |
| 401 | ip_not_allowed | 来源 IP 不在白名单 |
| 402 | insufficient_quota | 账户额度不足 |
| 429 | rpm_limit | 超过每分钟请求上限 |
| 429 | tpm_limit | 超过每分钟 Token 上限 |
| 429 | concurrency_limit | 超过并发上限 |
| 503 | no_channel_available | 没有可用渠道支持该模型 |
6. 常见问题
Q:调用报 503 no_channel_available?
说明没有渠道声明支持该模型,或渠道被自动禁用/分组不匹配。可联系管理员检查渠道配置与分组。
Q:流式响应怎么计费?
流式下上游通常不返回 usage,此时按请求体估算 Token 计费,与非流式的预估误差在 10% 内。
Q:如何提高可用性?
为同一模型配置多个渠道,设置不同优先级(主备)与权重,失败时网关会自动降级到低优先级渠道重试。