QUICK START
统一接口说明
兼容 OpenAI、Anthropic
客户端,服务会自动轮询号池账号并在失败时切换。
Base URL—
OpenAI 鉴权Authorization: Bearer <号池密钥>
Anthropic 鉴权x-api-key: <号池密钥>
所有模型使用普通模型名,通过
reasoning_effort、reasoning.effort 或
output_config.effort 设置 low、medium、
high、xhigh、max。
max 原样传递;仅 Sonnet 4.6 的 xhigh
映射为 high,其他模型的 xhigh 原样传递。
调用日志显示实际使用的档位。未指定档位时默认 medium。
所有模型均接收上游原生思考摘要,工具提示词不再要求模型在正文中生成思考内容。
会话粘性模式会自动匹配消息历史,续聊优先复用原账号。
已提供的 X-Session-ID 或请求体会话 ID 优先使用。
信息不足、历史有歧义时固定复用健康账号,不自动改为轮询。
只有选择“轮询”模式时才逐请求轮换。
绑定在最后一次使用后一小时过期;服务重启或切换模式后重新建立。
POST/v1/chat/completions
OpenAI Chat Completions 兼容接口,支持流式输出。
请求参数
modelstring · 必填模型名称messagesarray · 必填角色与内容数组streamboolean · 可选是否以 SSE 流式返回temperaturenumber · 可选采样温度
响应
{ "id": "chatcmpl-...", "choices": [{ "message": { "role": "assistant", "content": "..." } }] }
POST/v1/responses
OpenAI Responses API 兼容接口,适用于新一代 OpenAI SDK。
请求参数
modelstring · 必填模型名称inputstring / array · 必填用户输入内容streamboolean · 可选是否流式返回
响应
{ "id": "resp_...", "object": "response", "output": [{ "type": "message", "content": [{ "text": "..." }] }] }
POST/v1/messages
Anthropic Messages 兼容接口,可直接复用 Claude SDK。
请求参数
modelstring · 必填模型名称max_tokensinteger · 必填最大输出 token 数messagesarray · 必填对话消息数组streamboolean · 可选是否流式返回
响应
{ "id": "msg_...", "type": "message", "role": "assistant", "content": [{ "type": "text", "text": "..." }] }
GET/v1/models
获取当前服务可用的模型列表。
请求参数
无—仅需携带鉴权请求头
响应
{ "object": "list", "data": [{ "id": "claude-sonnet-4-5", "object": "model" }] }