跳转到主要内容

​
API key

所有 AI Sonar API 请求都需要 API key。 对于兼容 OpenAI 的端点，请按如下方式发送： 
Authorization: Bearer sk-your-api-key
对于兼容 Anthropic 的 /v1/messages 请求，你也可以使用： 
x-api-key: sk-your-api-key

​
获取你的 API key

  1. 登录你的 AI Sonar Dashboard
  2. 打开 API Keys
  3. 创建一个新 key
  4. 为其指定一个便于识别的名称
  5. 立即复制它，因为它只会显示一次
  • 绝不要在客户端代码中暴露 API key
  • 绝不要将 API key 提交到版本控制
  • 使用环境变量或 secret manager
  • 定期轮换 key
  • 删除未使用的 key

​
使用 API key

curl https://api.aisonar.dev/v1/responses \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "Hello!"
  }'

​
API key 特性

​
使用限制

你可以为每个 API key 设置使用限制：
设置描述
No Limitkey 可无限制地使用你的账户余额
Fixed Limitkey 在达到指定金额后将停止工作

​
key 前缀

所有 AI Sonar API key 都以 sk- 开头。

​
Anthropic 兼容性

对于 /v1/messages 端点，Anthropic 风格的请求头可按预期工作： 
curl https://api.aisonar.dev/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
对于兼容 OpenAI 的端点，例如 /v1/responses、/v1/chat/completions、/v1/models 以及大多数其他 AI Sonar 路由，请使用 Authorization: Bearer ...。

​
错误响应

状态码类型代码描述
401invalid_api_keyinvalid_api_key缺少或无效的 API key
401expired_api_keyexpired_api_keyAPI key 已被撤销
402insufficient_balanceinsufficient_balance账户余额不足
402quota_exceededquota_exceeded已达到 API key 使用限制
示例： 
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}