API 参考

接入协议

TokenAPIBay 同时支持 OpenAI 和 Anthropic 两种协议格式：

协议Header示例
OpenAIAuthorization: Bearer <key>Authorization: Bearer sk-xxx
Anthropicx-api-key: <key>x-api-key: sk-xxx

OpenAI 兼容接口

端点说明
POST /v1/chat/completions聊天补全

Anthropic 兼容接口

端点说明
POST /v1/messagesMessages API，兼容 Anthropic 格式

认证

OpenAPI 兼容端点使用 Bearer Token 认证：

HTTP Header
Authorization: Bearer sk-你的API密钥

API Key 以 sk- 开头，在控制台 API 管理 → API 密钥 创建。

速率限制

维度限制
IP10 req/min（默认）

超限返回 429：

JSON
{
  "error": {
    "code": "rate_limit_error",
    "type": "rate_limit_error",
    "message": "Rate limit exceeded"
  }
}

错误码

TokenAPIBay 在错误时返回与请求协议一致的错误格式：

HTTP 状态码

状态码说明处理建议
200请求成功-
400请求参数错误检查请求参数格式和必填字段
401认证失败检查 API Key 是否正确或是否已吊销，可在控制台重新生成
403权限不足检查账号认证状态或套餐权限
404接口或模型不存在验证请求路径和模型名称
429请求频率超限降低请求频率，或升级套餐提高限额
500服务器内部错误稍后重试，如持续失败请联系技术支持
502上游服务不可用检查模型提供商状态，稍后重试

OpenAI 错误格式

JSON
{
  "error": {
    "code": "insufficient_balance",
    "type": "insufficient_funds",
    "message": "账户余额不足"
  }
}

Anthropic 错误格式

JSON
{
  "type": "error",
  "error": {
    "type": "insufficient_funds",
    "message": "账户余额不足"
  }
}

端点列表

方法路径认证说明
POST/v1/chat/completions✅对话补全（OpenAI 兼容）
POST/v1/messages✅消息补全（Anthropic 兼容）
GET/v1/models✅列出可用模型
GET/v1/balance✅查询账户余额

GET /v1/models

获取当前用户可用的模型列表，返回 OpenAI 标准格式。

cURL
curl https://www.tokenapibay.com/v1/models \
  -H "Authorization: Bearer sk-你的API密钥"

响应 (200)：

JSON
{
  "object": "list",
  "data": [
    {
      "id": "deepseek-v4-flash",
      "object": "model",
      "owned_by": "deepseek",
      "max_context": 128000
    }
  ]
}
字段类型说明
idstring模型标识，请求时指定 model
objectstring固定为 "model"
owned_bystring模型所属厂商，从模型名自动解析
max_contextint最大上下文长度（token 数），工具据此自动 compact

GET /v1/balance

查询账户余额，包含充值余额和赠送余额。

cURL
curl https://www.tokenapibay.com/v1/balance \
  -H "Authorization: Bearer sk-你的API密钥"

响应 (200)：

JSON
{
  "object": "credit_grants",
  "balance": 100.50,
  "bonus_balance": 10.00,
  "total_balance": 110.50
}
字段类型说明
objectstring固定为 "credit_grants"
balancefloat充值余额
bonus_balancefloat赠送余额
total_balancefloat总余额