概览
API2GPT 是一个 OpenAI 兼容的大模型网关。一个账户、一个 Key，即可调用 GPT-4o、o1、Claude 3.5、Gemini Pro、DeepSeek、DALL·E 等主流模型，无需分别注册海外账号。
接入只有两步：在控制台创建 API Key，然后把客户端的 base_url 指向 api2gpt。其余代码无需改动。
提示：所有示例中的域名
https://api.api2gpt.com/v1 与密钥均为占位，请替换为控制台中的真实值。创建 API Key
- 使用邮箱注册并登录 控制台。
- 完成充值（余额通用于全部模型，按量计费）。
- 在「API Keys」中点击新建，复制以
sk-开头的密钥并妥善保存。 - 可为不同项目创建多个 Key，并分别设置消费上限。
替换 base_url
这是迁移的全部改动，通常只有一行：
# OpenAI Python SDK
client = OpenAI(
api_key="sk-你的-api2gpt-key",
base_url="https://api.api2gpt.com/v1", # 仅此一行
)
调用示例
cURL
curl https://api.api2gpt.com/v1/chat/completions \
-H "Authorization: Bearer $API2GPT_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "你好"}]
}'
Python
from openai import OpenAI
client = OpenAI(
api_key="sk-你的-api2gpt-key",
base_url="https://api.api2gpt.com/v1",
)
resp = client.chat.completions.create(
model="claude-3-5-sonnet",
messages=[{"role": "user", "content": "写一首七言绝句"}],
)
print(resp.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API2GPT_KEY,
baseURL: "https://api.api2gpt.com/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-4o",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
切换模型
同一个 Key、同一套接口，只需改变 model 字段即可在不同厂商的模型之间切换：
# 任选其一，无需更换 Key 或 base_url
model="gpt-4o" # OpenAI
model="o1" # OpenAI 推理
model="claude-3-5-sonnet" # Anthropic
model="gemini-1.5-pro" # Google
model="deepseek-chat" # DeepSeek
流式输出
设置 stream=True 即可逐段接收响应，适合聊天界面与长文本生成：
stream = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "讲个故事"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")
错误处理
接口返回标准 HTTP 状态码，常见情况：
401— 密钥无效或缺失，检查Authorization头。402— 余额不足，请前往控制台充值。429— 触发频率限制，建议指数退避后重试。5xx— 上游线路波动，网关会自动切换，重试通常即可恢复。