接口格式、限额与错误

一个地址，三种请求格式，一个密钥。这一页是概览，完整的接口、错误码和响应头见 API 文档。

接口

用你的工具原本就支持的格式。同一个密钥、同一份余额、同一套限额。

Anthropic Messages: POST /v1/messages · 接口地址 https://api.6bee.ai。适用于 Claude Code 和 Anthropic SDK。用 x-api-key 或 Bearer 令牌认证，错误按 Anthropic 格式返回。
OpenAI Responses: POST /v1/responses · 接口地址 https://api.6bee.ai/v1。适用于 Codex。每轮发送完整输入；不支持 store、previous_response_id 和 WebSocket 模式。
OpenAI Chat Completions: POST /v1/chat/completions · 接口地址 https://api.6bee.ai/v1。适用于 OpenCode、Cherry Studio、Cline 等工具和 OpenAI SDK。用 Bearer 令牌认证。模型列表：GET /v1/models。
模型列表: GET /v1/models 返回你的密钥可用的模型 ID。

三种接口都支持 SSE 流式输出。

认证

在控制台创建密钥，以 Authorization: Bearer <你的密钥> 发送。Anthropic 格式也接受 x-api-key 请求头。

shell

curl https://api.6bee.ai/v1/chat/completions \
  -H "Authorization: Bearer $SIXBEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "<模型 id>", "stream": true, "max_tokens": 2048,
       "messages": [{"role": "user", "content": "给 fizzbuzz 写一个单元测试"}]}'

限额

测试期限额按账户计算，同一账户的所有密钥合计。

上下文: 输入加输出不超过模型窗口：按模型不同，为 128K 至 1M token。
输出: max_tokens 最高到模型的输出上限：按模型不同，为 16,384 至 131,072。超出时自动降到上限，不会拒绝请求。不传时默认 8,192 至 32,768。
输入: 滚动每分钟 100 万未命中缓存的 token，缓存命中不计。
请求频率: 每分钟 60 次。
并发: 同时 2 个请求。
请求体: 不超过 8 MiB，n 必须为 1。

错误

HTTP 429: 超出频率、token 或并发限额。等待 Retry-After 给出的秒数。
HTTP 400: 请求放不进模型的上下文窗口，或使用了不支持的参数。
输出上限被降低: max_tokens 超过上限时会被降低，而不是拒绝。实际上限在响应头 X-6bee-Output-Cap 中。在 /v1/messages 上，thinking 预算会一并降低。

在 /v1/messages 上，错误按 Anthropic 的格式返回，Anthropic 客户端可以照常处理。

不支持的功能

「兼容」指请求格式大体一致，不代表其他 API 的每个功能都有：

Responses 接口的 store、previous_response_id 和 WebSocket 模式。
n 不为 1 的请求。
某个模型没有实现的参数。不同模型的行为有差异。

计费

余额按各模型单价、按 token 扣费。每次请求先预扣「输入 + max_tokens 输出」，结束后只按实际用量结算，差额退回余额。

各模型的 token 单价见控制台。