API Key 与鉴权
The guide below is in Chinese.
先创建一把模型调用 Key,再用一次只读请求验证鉴权。
创建模型调用 Key
- 打开工作台的「API 密钥」,创建一把以
sk-开头的 Key。 - 用服务端环境变量
TP_API_KEY或密钥管理工具保存它,示例从环境变量读取。请勿把它写进前端、代码仓库或日志。
用一次请求检查鉴权
Shell command
curl "https://intertoken.ai/v1/models" \
-H "Authorization: Bearer ${TP_API_KEY}"成功时响应中的 data 包含当前 Key 可见的模型,取 data[].id 作为调用时的 model。
应用接入该用哪种 Key?
sk- · 调用模型
用于对话、图片、视频等模型接口,只保存在服务端。
pk- · 前端可公开
应用公钥可用于应用获准开放的接口,例如公开目录,按配置校验请求域名。
ak- · 应用管理,必须保密
用于应用管理和该应用获准的管理接口。pk- 与 ak- 随应用创建,只把 pk- 放在前端。
收到 401 怎么排查?
检查 Authorization: Bearer <Key>,确认 Key 仍有效,且 Key 类型、接口与环境一致。反馈时附错误码和发生时间,请勿附上密钥。
Key 泄露了怎么办
在创建该 Key 的页面撤销或重置,按页面提示切换到新 Key。应用的 pk- 和 ak- 重置后,旧 Key 仍有 24 小时并行期,请确认所有服务都换用了新 Key。