接入文档

兼容 OpenAI 与 Anthropic 格式，最小化迁移成本。

快速开始

1. 获取 API密钥

登录后，在控制台 → API密钥 页面创建您的 Token。

2. 替换接口地址

将官方端点替换为我们的中转端点：

# 原官方端点
POST https://api.openai.com/v1/chat/completions

# 替换为我们的端点
POST {{location.origin}}/v1/chat/completions

3. 在请求中携带 Token

# 方式一：Authorization Header（推荐）
curl {{location.origin}}/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[...]}'

# 方式二：X-Api-Key Header
curl {{location.origin}}/v1/chat/completions \
  -H "X-Api-Key: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[...]}'

对话接口

OpenAI 兼容格式

POST /v1/chat/completions

请求示例：

{
  "model": "gpt-4o",
  "messages": [
    {"role": "user", "content": "你好"}
  ],
  "stream": true,
  "temperature": 0.7,
  "max_tokens": 2048
}

支持参数：

参数类型说明
modelstring模型名称，如 gpt-4o、claude-3-sonnet
messagesarray对话消息列表
streamboolean是否流式返回（默认 false）
temperaturefloat采样温度，0-2（默认 1）
max_tokensint最大输出 tokens

流式响应

设置 stream: true 后，接口以 SSE（Server-Sent Events）格式返回数据：

# SSE 数据流格式
data: {"id":"...","choices":[{"delta":{"content":"你"}}]}

data: {"id":"...","choices":[{"delta":{"content":"好"}}]}

data: [DONE]

图片生成

POST /v1/images/generations

{
  "model": "dall-e-3",
  "prompt": "一只坐在月亮上的猫",
  "n": 1,
  "size": "1024x1024"
}

向量嵌入

POST /v1/embeddings

{
  "model": "text-embedding-3-small",
  "input": "你好世界"
}

Anthropic 格式

POST /v1/messages

{
  "model": "claude-3-sonnet",
  "max_tokens": 2048,
  "messages": [
    {"role": "user", "content": "你好"}
  ]
}

模型列表

通过 GET /v1/models 获取所有可用模型列表，无需认证，兼容 OpenAI SDK 模型探测。

# 请求示例
curl {{location.origin}}/v1/models

返回格式与 OpenAI 保持一致，包含模型 ID、创建时间、所属组织等信息。

错误码

HTTP 状态码说明
400请求参数错误
401API密钥 无效或已过期
403Token 已被禁用
429请求频率超限或余额不足
500上游服务错误