开发文档
身份验证
所有请求均使用服务 API 密钥进行验证。密钥仅在签发时显示一次,服务器仅保留哈希与预览字符串。
请求头
在 Authorization 请求头中以 Bearer 令牌传入。若因代理环境无法使用 Authorization,也接受 X-API-Key。两者同时发送时以 Authorization 为准。
作用于密钥的限制
可为每个密钥单独设置预算、允许的 IP 与可调用模型。判定顺序为组织屏蔽列表、密钥使用范围、路由模板,此顺序不会改变。
- 超出累计、每日或每月额度时返回 402。
- 从允许的 IP 之外调用时返回 403。
- 指定超出密钥范围的模型时返回 403。
作废与轮换
将密钥切换为停用后,进行中的请求也会立即中断。若要无中断轮换,请先签发并部署新密钥,待旧密钥用量归零后再作废。