API 文档

完全兼容 OpenAI 协议,5 分钟接入。本站差异以 ⚡ 标注。

最后更新:2026-05-01

认证

所有请求必须在 Header 中携带 Bearer Token,格式与 OpenAI 一致。前往「我的密钥」页面创建并管理 API Key。

⚡ 本站差异:API Key 支持绑定分组、IP 白名单、并发上限,详见控制台。

header
Authorization: Bearer sk-xxx

Base URL

将 OpenAI 官方 base_url 替换为下方地址即可,SDK 与代码无需任何修改。

OpenAI 协议
https://your-domain.com/v1
Anthropic 协议
https://your-domain.com/v1
Gemini 协议
https://your-domain.com/v1beta

模型与分组

通过 GET /v1/models 获取当前可用模型列表,结合「价格分组」可享受不同倍率,VIP 用户可享受更低价格。

cURL
curl https://your-domain.com/v1/models -H "Authorization: Bearer sk-xxx"

Chat Completions

POST /v1/chat/completions,请求体与 OpenAI 完全一致,支持流式响应(stream: true)。

⚡ 本站差异:响应 Header 中会附加 X-Request-Id 与 X-Channel,方便排查与对账。

cURL
curl https://your-domain.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "stream": true
  }'

在控制台 → 我的密钥 创建后即可使用

Embeddings

POST /v1/embeddings,向量化文本,支持 text-embedding-3-small/large 等模型。

cURL
curl https://your-domain.com/v1/embeddings \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Your text string goes here"
  }'

Images

POST /v1/images/generations,DALL·E 3 / SD3 等模型,支持 b64_json 与 url 两种返回。

cURL
curl https://your-domain.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "a sleepy cat in a bookstore",
    "n": 1,
    "size": "1024x1024"
  }'

Audio

POST /v1/audio/speech 与 /v1/audio/transcriptions,TTS 与 STT 兼容 OpenAI 协议。

cURL
curl https://your-domain.com/v1/audio/speech \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-1",
    "input": "Hello world",
    "voice": "alloy"
  }' --output speech.mp3

Anthropic Messages

POST /v1/messages,原生 Anthropic 协议透传,支持 tools、prompt caching、extended thinking。

cURL
curl https://your-domain.com/v1/messages \
  -H "x-api-key: sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-latest",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'

错误码

全部错误响应统一为 {"error":{"type":"...","message":"..."}} 结构,HTTP 状态码与 OpenAI 一致。

HTTPtypemessage
401auth_errorAPI Key 无效、被禁用或缺失
402insufficient_quota余额或额度不足
403forbiddenKey 不在分组允许范围内
429rate_limited并发或 RPM 超限
500upstream_error上游服务异常
503channel_unavailable无可用渠道,已自动重试失败

限流

免费用户默认 RPM=60,付费用户 RPM=600,企业组可定制。响应 Header 携带 X-RateLimit-Remaining。

计费

按实际 prompt_tokens + completion_tokens 实时扣费,企业账号按企业协议统一结算,用量明细可在控制台实时查询。