快速开始

API 概览

文档最后更新于 2026年10月16日 02:29

各厂商原生协议的端点对照、鉴权请求头、停止原因字段与 token 用量位置。

云上创造 直接透传各厂商模型的原生协议:将官方 SDK 的 Base URL 指向 云上创造 即可,无需修改业务代码。Base URL 有两个:国内通道 https://api.acapi.top、国外通道 https://acapi.top,模型数量完全一样、鉴权与价格相同,按你主要调用的模型选(见下方「调用地址」与 协议选择 的「通道选择」);用量与账单接口在两个地址下都可访问。

调用地址
国内通道 URL
https://api.acapi.top

国内模型(DeepSeek、Qwen、GLM、Kimi、豆包、MiniMax 等)走这里响应更快

国外通道 URL
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 ResponsesPOST /v1/responses全部文本模型系列(见协议支持的模型)
Gemini 原生POST /v1beta/models/{model}:generateContent仅 Gemini
以 OpenAI 兼容格式调用 Claude 会丢失 prompt cache、thinking 等能力;Claude 系列推荐用 /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 可省略。不确定该用哪种协议,见 协议选择。

完成原因

各协议以各自的字段表示生成停止的原因:

协议字段常见取值
Anthropicstop_reasonend_turn、tool_use
OpenAIchoices[].finish_reasonstop、tool_calls
Geminicandidates[].finishReasonSTOP

查询消耗与用量

每个响应都包含 token 用量:Anthropic 在 usage,OpenAI 在 usage,Gemini 在 usageMetadata,字段名随协议而异。每次调用的响应头还包含 X-Oneapi-Request-Id,其值就是 查询单次请求用量 返回的 request_id,可用于反查这次请求的最终费用;按 API Key 汇总见 查询 Token 用量 与 查询账单汇总。

共 30 篇文档。文中出现的模型名与价格以模型广场的实时数据为准。