通过 云上创造，一个 API Key 即可调用 Claude、GPT、Gemini、DeepSeek 等主流模型。请求按模型所属的协议发送，响应保持该协议的原始结构。
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
- 1.在 控制台 创建 API Key。
- 2.发送第一个请求。以 Claude 为例：
Claude 是海外模型，下面的示例用国外通道 https://acapi.top；国内模型示例见本节末尾。两个地址均可用，见上方「调用地址」。
curl https://acapi.top/v1/messages \
-H "x-api-key: sk-xxxxxx" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "你好"}]
}'Python：
import requests
resp = requests.post(
"https://acapi.top/v1/messages",
headers={
"x-api-key": "sk-xxxxxx",
"anthropic-version": "2023-06-01",
"content-type": "application/json",
},
json={
"model": "claude-sonnet-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "你好"}],
},
)
print(resp.json()["content"][0]["text"])TypeScript：
const resp = await fetch("https://acapi.top/v1/messages", {
method: "POST",
headers: {
"x-api-key": "sk-xxxxxx",
"anthropic-version": "2023-06-01",
"content-type": "application/json",
},
body: JSON.stringify({
model: "claude-sonnet-5",
max_tokens: 256,
messages: [{ role: "user", content: "你好" }],
}),
});
const data = await resp.json();
console.log(data.content[0].text);国内模型（以 DeepSeek 为例，OpenAI 兼容格式）用国内通道 https://api.acapi.top 响应更快：
curl https://api.acapi.top/v1/chat/completions \
-H "Authorization: Bearer sk-xxxxxx" \
-H "content-type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"messages": [{"role": "user", "content": "你好"}]
}'响应示例
{
"id": "msg_01KxDE...",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-5",
"content": [{ "type": "text", "text": "你好！有什么可以帮你的？" }],
"stop_reason": "end_turn",
"usage": { "input_tokens": 9, "output_tokens": 12 }
}回复文本在 content 数组里 type 为 text 的块中。字段的完整说明见 创建消息。
- ·调用失败时返回
error对象（含message、type、code），message末尾带本次请求 ID；常见的是 401（鉴权未通过）和 403（余额不足），对照表见 错误码。 - ·文本模型三种协议（Anthropic Messages、OpenAI Chat Completions、OpenAI Responses）都可调用，网关自动转换；推荐用模型本族协议（Claude 用 Anthropic 原生格式，GPT 用 OpenAI 格式），Gemini 原生格式仅 Gemini 系。完整对照见 API 概览。模型 ID 以
GET /v1/models返回为准。 - ·非流式请求（
stream不传或为false）经公网访问时，如果 30 秒内还没返回首字节，可能被网络边缘断开，客户端会收到空响应或连接中断，但服务端可能仍在生成、照常计费。推理模型、长输出、大上下文请务必用stream: true（SSE 有保活，不受此限制）。Claude Code、Codex、Cherry Studio 默认都是流式，不受 30 秒限制；流式也请把客户端读超时调大（Claude 系 ≥300 秒，其它模型 ≥150 秒），见 创建对话补全 的「客户端读超时」。
使用官方 SDK
将官方 SDK 的 api_key 设为 云上创造 API Key、base_url 指向 云上创造，业务代码无需修改：Anthropic SDK 用调用地址本身（如 https://acapi.top），OpenAI SDK 在调用地址后加 /v1（如 https://api.acapi.top/v1），Google GenAI SDK 同样用调用地址本身。调用地址按模型选：国内模型用国内通道 https://api.acapi.top，海外模型用国外通道 https://acapi.top，两个地址的模型完全一样。各 SDK 示例见对应端点页：创建消息、创建对话补全、生成内容。
在 Agent 工具中使用
Claude Code、Codex、Cursor 等工具只需将 Base URL 与 API Key 改为本站的值 —— 三种协议的端点与鉴权方式见 API 概览，Base URL 填调用地址（国内通道 https://api.acapi.top 或国外通道 https://acapi.top）：Anthropic 协议直接填地址，OpenAI 协议在地址后加 /v1。主要用海外模型（如 Claude）选国外通道，主要用国内模型选国内通道。
Claude Code 用环境变量配置（macOS / Linux 示例；Windows 用对应方式设置同名变量）：
export ANTHROPIC_BASE_URL=https://acapi.top
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxx
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
claude也可以写进 ~/.claude/settings.json 的 env：
{
"env": {
"ANTHROPIC_BASE_URL": "https://acapi.top",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxxx",
"ANTHROPIC_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5"
}
}claude-sonnet-5）。遇到「会话历史与当前线路不兼容」时，执行 /compact 或新开会话再试。tool_reference 块；网关在转发给上游前自动剥除这些块（工具定义仍在 tools 里），客户端不用改配置。如果你在本站前面还自建了一层代理，也建议同样剥除。后续步骤
- ·三种协议各自的端点：API 概览
- ·逐 token 返回生成结果：流式输出
- ·采样参数在三种协议里的字段名：参数说明
- ·让模型调用自定义函数：工具调用
- ·向模型发送图片：图像输入