云上创造 直接透传各厂商模型的原生协议:将官方 SDK 的 Base URL 指向 云上创造 即可,无需修改业务代码。Base URL 有两个:国内通道 https://api.acapi.top、国外通道 https://acapi.top,模型数量完全一样、鉴权与价格相同,按你主要调用的模型选(见下方「调用地址」与 协议选择 的「通道选择」);用量与账单接口在两个地址下都可访问。
https://api.acapi.top国内模型(DeepSeek、Qwen、GLM、Kimi、豆包、MiniMax 等)走这里响应更快
https://acapi.top海外文本模型(GPT、Claude、Gemini、Grok 等)走这里响应更快
区别是国内模型走国内通道响应更快,国外模型走国外通道响应更快;两个 URL 的模型数量都是一样的,同一个 API Key、同样的价格,任选一个都能调用全部模型。OpenAI 兼容客户端的 Base URL 在地址后加 /v1(如 https://api.acapi.top/v1)。
请求格式
按模型选择协议,端点与请求体格式与对应的官方 API 一致。每个协议支持哪些模型系列,完整对照见 协议支持的模型:
| 协议 | 端点 | 适用模型 |
|---|---|---|
| Anthropic 原生 | POST /v1/messages | 全部文本模型系列(Claude 的推荐入口;其它模型由网关自动转换) |
| OpenAI 兼容 | POST /v1/chat/completions | 全部文本模型系列(Claude 不建议;gpt-6.1-sol 推荐 Responses) |
| OpenAI Responses | POST /v1/responses | 全部文本模型系列(见协议支持的模型) |
| Gemini 原生 | POST /v1beta/models/{model}:generateContent | 仅 Gemini |
/v1/messages(Responses API 也可)。请求体为 JSON,content-type: application/json。请求头
鉴权请求头有三种(Authorization: Bearer、x-api-key、x-goog-api-key),适用范围见 鉴权:Authorization: Bearer 全部端点通用;x-api-key 只在 /v1/messages、/v1/models 有效;x-goog-api-key 只在 Gemini 原生端点有效。Anthropic 格式的 anthropic-version 可省略。不确定该用哪种协议,见 协议选择。
完成原因
各协议以各自的字段表示生成停止的原因:
| 协议 | 字段 | 常见取值 |
|---|---|---|
| Anthropic | stop_reason | end_turn、tool_use |
| OpenAI | choices[].finish_reason | stop、tool_calls |
| Gemini | candidates[].finishReason | STOP |
查询消耗与用量
每个响应都包含 token 用量:Anthropic 在 usage,OpenAI 在 usage,Gemini 在 usageMetadata,字段名随协议而异。每次调用的响应头还包含 X-Oneapi-Request-Id,其值就是 查询单次请求用量 返回的 request_id,可用于反查这次请求的最终费用;按 API Key 汇总见 查询 Token 用量 与 查询账单汇总。