ApiGate 接入文档
使用 OpenAI 兼容接口调用控制台中已开放的模型。API 基础地址为 https://apigate.club/v1。
ApiGate 是独立 API 服务平台,并非 OpenAI、Anthropic 或其他模型厂商的官方网站。模型可用范围与价格以控制台实时展示为准。
快速开始
- 注册并登录 ApiGate。
- 进入“令牌”页面创建 API Key。
- 在“模型”页面确认当前可用模型。
- 将客户端的 Base URL 设置为
https://apigate.club/v1。
建议:为不同应用分别创建令牌,设置额度和到期时间,便于追踪与停用。
curl 示例
查询模型
curl https://apigate.club/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
聊天补全
curl https://apigate.club/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "控制台中的模型名称",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'
Python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://apigate.club/v1",
)
response = client.chat.completions.create(
model="控制台中的模型名称",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.APIGATE_API_KEY,
baseURL: "https://apigate.club/v1",
});
const response = await client.chat.completions.create({
model: "控制台中的模型名称",
messages: [{ role: "user", content: "你好" }],
});
console.log(response.choices[0].message.content);
常见错误
| 状态码 | 说明 | 处理方式 |
|---|---|---|
| 401 | 令牌无效或已停用 | 检查 API Key,确认没有多余空格并且令牌仍有效。 |
| 429 | 请求过快或额度不足 | 降低并发、稍后重试,并查看控制台余额与令牌额度。 |
| 500/502/503 | 上游或网关暂时异常 | 使用指数退避重试;持续异常时停止重试并查看公告。 |
安全建议
- 不要把 API Key 写入网页前端、公开仓库或截图。
- 通过环境变量或密钥管理服务保存令牌。
- 为令牌设置最小必要额度、允许的模型和到期时间。
- 发现泄露后立即删除旧令牌并创建新令牌。
服务说明
接口可用性、模型列表和计费倍率可能因上游变化而调整,调整结果以控制台和站内公告为准。请勿将服务用于违法、侵权、欺诈、攻击或绕过第三方平台限制的活动。
账户或调用异常请保留请求时间、模型名称和 Request ID,通过平台公布的客服渠道联系运营方;不要发送完整 API Key。