认证
所有请求必须在 Header 中携带 Bearer Token,格式与 OpenAI 一致。前往「我的密钥」页面创建并管理 API Key。
⚡ 本站差异:API Key 支持绑定分组、IP 白名单、并发上限,详见控制台。
Authorization: Bearer sk-xxx
Base URL
将 OpenAI 官方 base_url 替换为下方地址即可,SDK 与代码无需任何修改。
https://your-domain.com/v1https://your-domain.com/v1https://your-domain.com/v1beta模型与分组
通过 GET /v1/models 获取当前可用模型列表,结合「价格分组」可享受不同倍率,VIP 用户可享受更低价格。
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 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 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 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 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.mp3Anthropic Messages
POST /v1/messages,原生 Anthropic 协议透传,支持 tools、prompt caching、extended thinking。
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 一致。
| HTTP | type | message |
|---|---|---|
| 401 | auth_error | API Key 无效、被禁用或缺失 |
| 402 | insufficient_quota | 余额或额度不足 |
| 403 | forbidden | Key 不在分组允许范围内 |
| 429 | rate_limited | 并发或 RPM 超限 |
| 500 | upstream_error | 上游服务异常 |
| 503 | channel_unavailable | 无可用渠道,已自动重试失败 |
限流
免费用户默认 RPM=60,付费用户 RPM=600,企业组可定制。响应 Header 携带 X-RateLimit-Remaining。
计费
按实际 prompt_tokens + completion_tokens 实时扣费,企业账号按企业协议统一结算,用量明细可在控制台实时查询。