API Key 与鉴权

The guide below is in Chinese.

先创建一把模型调用 Key,再用一次只读请求验证鉴权。

创建模型调用 Key

  1. 打开工作台的「API 密钥」,创建一把以 sk- 开头的 Key。
  2. 用服务端环境变量 TP_API_KEY 或密钥管理工具保存它,示例从环境变量读取。请勿把它写进前端、代码仓库或日志。

用一次请求检查鉴权

Shell command
curl "https://staging-dp.taotoken.io/v1/models" \
  -H "Authorization: Bearer ${TP_API_KEY}"

成功时响应中的 data 包含当前 Key 可见的模型,取 data[].id 作为调用时的 model。

下一步 · 查模型 ID 并发出对话请求 · 查看其他协议地址

应用接入该用哪种 Key?

sk- · 调用模型

用于对话、图片、视频等模型接口,只保存在服务端。

pk- · 前端可公开

应用公钥可用于应用获准开放的接口,例如公开目录,按配置校验请求域名。

ak- · 应用管理,必须保密

用于应用管理和该应用获准的管理接口。pk- 与 ak- 随应用创建,只把 pk- 放在前端。

收到 401 怎么排查?

检查 Authorization: Bearer <Key>,确认 Key 仍有效,且 Key 类型、接口与环境一致。反馈时附错误码和发生时间,请勿附上密钥。

查找 401 错误

Key 泄露了怎么办

在创建该 Key 的页面撤销或重置,按页面提示切换到新 Key。应用的 pk- 和 ak- 重置后,旧 Key 仍有 24 小时并行期,请确认所有服务都换用了新 Key。