接入文档

我的令牌

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. 限流与错误码

HTTPcode说明
401token_not_found令牌不存在
401token_disabled令牌已禁用
401token_expired令牌已过期
401model_not_allowed令牌无权访问该模型
401ip_not_allowed来源 IP 不在白名单
402insufficient_quota账户额度不足
429rpm_limit超过每分钟请求上限
429tpm_limit超过每分钟 Token 上限
429concurrency_limit超过并发上限
503no_channel_available没有可用渠道支持该模型

6. 常见问题

Q:调用报 503 no_channel_available?

说明没有渠道声明支持该模型,或渠道被自动禁用/分组不匹配。可联系管理员检查渠道配置与分组。

Q:流式响应怎么计费?

流式下上游通常不返回 usage,此时按请求体估算 Token 计费,与非流式的预估误差在 10% 内。

Q:如何提高可用性?

为同一模型配置多个渠道,设置不同优先级(主备)与权重,失败时网关会自动降级到低优先级渠道重试。