Skip to content

认证

Pixapi 使用标准 Bearer Token 方式认证 API Key。

http
Authorization: Bearer $PIXAPI_KEY

创建密钥

  1. 登录 Pixapi 控制台
  2. 打开 Settings -> API Keys
  3. 创建密钥并立即复制。
  4. 将密钥保存到服务端环境变量中。
bash
export PIXAPI_KEY="sk_..."

发送 Header

bash
curl https://api.pixapi.ai/v1/models \
  -H "Authorization: Bearer $PIXAPI_KEY"

密钥安全

  • 不要把 Pixapi Key 放到客户端 JavaScript。
  • 成员离开或部署密钥泄露时,在 API Keys 及时轮换。
  • 开发、预发、生产环境使用不同 API Keys
  • 在转发到 Pixapi 前,为你的用户添加自己的限流和权限检查。

无效凭证

凭证缺失或无效时返回 401 Unauthorized

json
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key."
  }
}