身份认证

最后更新：2026-04-24 · 预计阅读 6 分钟

TTToken 使用 Bearer Token 作为统一鉴权方式。你在控制台 · 令牌生成的 sk-xxx 密钥即可用于所有协议。

Bearer Token 用法

OpenAI 协议

在请求头中加入 Authorization: Bearer <key>：

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Anthropic 协议

Anthropic SDK 使用 x-api-key 头。TTToken 同时支持 x-api-key 和 Authorization: Bearer：

x-api-key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
anthropic-version: 2023-06-01
Content-Type: application/json

Google Gemini 协议

Gemini 既可以使用 x-goog-api-key 头，也可以通过 ?key= query 参数：

# 方式 A：Header
x-goog-api-key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 方式 B：Query
https://tttoken.xyz/v1beta/models/gemini-2.5-pro:generateContent?key=sk-xxx

分组（Group）

TTToken 使用「分组」机制，把同一个模型分配到不同的上游渠道池。不同分组在稳定性、速度和计费倍率上有区别。常见分组：

分组	倍率	说明
`default`	1×	主力渠道，性价比最高
`vip`	1.2×	高并发、低排队
`svip`	1.5×	企业级 SLA
`official`	参考官方	直连厂商官方，零中转

通过在请求 Header 中加入 X-Group 来显式指定：

curl https://tttoken.xyz/v1/chat/completions \
  -H "Authorization: Bearer $TTT_KEY" \
  -H "X-Group: vip" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5","messages":[{"role":"user","content":"ping"}]}'

未指定时将按照令牌绑定的默认分组或账户默认分组分发。完整分组倍率请在控制台「定价」页查看。

额度与限速

额度

每个令牌都有独立额度（美元），消费达到上限后自动停用。你可以：

创建多个令牌（按项目/成员划分），彼此隔离。
在令牌详情页随时调整额度或吊销。
用于演示/测试的临时令牌可以设置较小额度兜底。

限速

TTToken 对所有请求做分桶限速：

RPM：每分钟请求数，默认分组 180 RPM，VIP 600 RPM。
TPM：每分钟 token 数，根据模型容量动态调整。
被限流时返回 HTTP 429，响应头包含 Retry-After 秒数。

处理建议参考错误码 · 429。

验证令牌

最简单的验证方式是请求模型列表，成功返回即说明鉴权通过：

curl https://tttoken.xyz/v1/models \
  -H "Authorization: Bearer $TTT_KEY"