认证方式

词驿使用 Bearer Token 认证，所有接口都需要在请求头携带 API Key。

请求头

Authorization: Bearer sk-你的令牌

令牌（Token）在控制台「令牌」页面创建，形如 sk-xxxxxxxx。

令牌与分组

每个令牌可绑定以下属性：

• 可用分组：决定该令牌走哪个上游渠道（如 default、官转OpenAI 等），不同分组价格倍率不同。
• 额度上限：限制该令牌最多消费多少配额，超额自动拒绝。
• 有效期：到期自动失效。
• 可用模型：限制该令牌能调用哪些模型范围。
• IP 限制：可选，限制调用来源 IP。

多令牌管理

建议为不同场景（个人使用、生产应用、测试）创建不同令牌，便于用量追踪与额度控制。令牌的增删改查也可通过 API 完成，见令牌管理。

切换分组（请求级）

除在令牌上绑定分组外，也可在单次请求里临时指定分组：

Authorization: Bearer sk-你的令牌
X-Api-User-Group: 官转OpenAI

该请求会走指定分组计费，不影响令牌默认分组。

保管好你的 Key

API Key 等同于账户凭证，请勿提交到代码仓库或泄露给他人。如怀疑泄露，立即在控制台删除并重建令牌。