鉴权

所有接口用同一种凭证：在控制台创建的 API Key，随请求放在 Authorization 头里。没有别的鉴权方式，也没有按接口不同的规则。

一个头

Authorization: Bearer {key}

一个 Key 通所有前缀下的接口。Key 在控制台 → API Key 创建、轮换和吊销；吊销立即生效。

各家 SDK 把 Key 放在哪

你不需要自己拼这个头——官方 SDK 会放；我们同时接受各家 SDK 默认使用的头名。

试一条

curl https://api.deepraxis.ai/model/v1/models \
  -H "Authorization: Bearer $PRAXIS_API_KEY"

鉴权失败长什么样

Key 缺失、无效或已吊销，返回 401，错误体按该前缀的格式（见错误）。收到 401 不要重试——换对 Key 再发。

保管

• 只在服务端使用；不要放进浏览器、移动端或公开仓库。
• 用环境变量（示例里的 PRAXIS_API_KEY），不要写进代码。
• 怀疑泄露时在控制台吊销并新建，旧 Key 立即失效。