OpenAI 兼容 API

x001.ai 暴露 OpenAI 兼容接口。大多数 OpenAI SDK 或兼容客户端只需要替换 Base URL 和 API Key。

Base URL

https://x001.ai/v1

认证

所有 API 请求都应携带 Bearer Token：

Authorization: Bearer <your-api-key>

Chat Completions

curl https://x001.ai/v1/chat/completions \
  -H "Authorization: Bearer $X001_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "写一个三行的使用建议" }
    ],
    "temperature": 0.7
  }'

Embeddings

curl https://x001.ai/v1/embeddings \
  -H "Authorization: Bearer $X001_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "x001.ai 文档"
  }'

Responses

如果你的账号可用模型支持 Responses API，可以使用：

curl https://x001.ai/v1/responses \
  -H "Authorization: Bearer $X001_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "input": "总结一下 AI API 中转站的作用"
  }'

错误排查

现象	常见原因
401	API Key 错误、令牌被禁用或未携带 Authorization
403	用户分组无权限、模型不可用或账号状态异常
404	路径错误或模型名称不可用
429	触发限流、额度不足或上游限速
500	服务暂时异常或模型服务返回错误

建议排查顺序：

1. 确认 API Key 和 Base URL。
2. 在控制台检查最近的调用记录。
3. 检查模型名和账号可用权限。
4. 使用较小请求体复现问题。