概览
API2GPT 是一个 OpenAI 接口格式兼容的大模型网关。一个账户、一个 Key，可按控制台当前提供的模型 ID 调用对话、推理、视觉等能力，无需分别维护多套接口配置。
接入只有两步：在控制台创建 API Key，然后把客户端的 base_url 指向 api2gpt。其余代码无需改动。
提示：示例中的密钥和
your-model-id 均为占位。调用前请从控制台复制当前可用的模型 ID，并核对对应参数说明。创建 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": "your-model-id",
"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="your-model-id",
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: "your-model-id",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
切换模型
同一个 Key、同一套接口，只需把 model 字段替换成控制台当前展示的模型 ID。模型名称、参数与可用状态可能调整，应以控制台说明为准。
# 从控制台复制当前模型 ID
model="your-model-id"
流式输出
设置 stream=True 即可逐段接收响应，适合聊天界面与长文本生成：
stream = client.chat.completions.create(
model="your-model-id",
messages=[{"role": "user", "content": "讲个故事"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")
错误处理
接口返回标准 HTTP 状态码，常见情况：
401— 密钥无效或缺失，检查Authorization头。402— 余额不足，请前往控制台充值。429— 触发频率限制，建议指数退避后重试。5xx— 可能来自网关或上游线路波动，建议按退避策略重试；持续失败时联系支持。