像接 OpenAI 一样接入多模型网关

使用 Bearer Key 和平台模型名发起请求。OneKeyToken 负责模型映射、路由、内容安全、Token 计量、统一错误码和账本归因。

开始接入应用计费接入

POST /v1/chat/completions
Authorization: Bearer okt-app-live-...
Content-Type: application/json

{
  "model": "onekeytoken/auto",
  "customer_id": "cust_10086",
  "user_id": "user_20001",
  "messages": [
    { "role": "user", "content": "生成周报摘要" }
  ]
}

快速接入

1. 创建 Key

账号直连使用个人 API Key；B2B2C 应用流量使用应用接入密钥。

2. 替换 Base URL

保持 SDK 调用方式，仅替换 base_url 和模型名。

3. 追踪用量

每次请求返回 usage，并按 request_id 写入账本。

curl https://api.onekeytoken.cn/v1/chat/completions \
  -H "Authorization: Bearer okt-user-live-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{ "role": "user", "content": "生成周报摘要" }]
  }'

应用计费接入

应用接入密钥必须保存在服务端。终端应用请求你的后端，由后端携带 customer_id 和可选 user_id 转发到 OneKeyToken。

字段	是否必填	用途
Authorization	必填	Bearer 应用接入密钥或个人 API Key
model	可选	可传 onekeytoken/auto 使用路由策略
customer_id	建议必填	客户钱包、额度、预警和账单归因
user_id	可选	客户下终端用户用量归集
request_id	建议传入	幂等追踪与对账定位

计费字段

{
  "request_id": "req_8bx7f2",
  "model": "deepseek-chat",
  "usage": {
    "prompt_tokens": 1240,
    "completion_tokens": 876,
    "charged_amount_cents": 299
  }
}

平台记录模型、Key、request_id、customer_id、user_id、输入/输出 Token、价格版本和余额变化。

核心错误码

错误码	HTTP	说明	建议动作
invalid_api_key	401	Key 无效、停用或已删除	检查 Key 前缀与状态
insufficient_balance	402	余额不足以完成预冻结	充值或调整客户钱包
content_blocked	400	命中内容安全策略	调整提示词或进入复核
rate_limited	429	超过 Key、模型或客户限额	降低并发或提升限额
upstream_unavailable	503	上游不可用或熔断	切换备用模型或等待恢复

合规说明

上线前需由法务、财务和网安合规负责人复核 ICP 备案、用户协议、隐私政策、实名认证、内容安全流程、模型备案公示和跨境数据处理。