APIGOTO API 文档
APIGOTO 是一个统一的大模型 API 网关。它把 OpenAI、Anthropic、Google 等厂商的原生协议收敛到同一个 Base URL 与同一把 API Key 之下——你不需要为每家厂商各写一套客户端,也不需要各自申请、各自续费。
接入方式
APIGOTO 的对外接口与各厂商官方协议保持字段级兼容。你继续用官方 SDK,只需要替换两个值:
base_url 和 api_key。请求体、响应体、流式事件都由网关原样透传上游,不做结构改写。
curl https://www.apigoto.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $APIGOTO_API_KEY" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "你好"}]
}'
from openai import OpenAI
client = OpenAI(
base_url="https://www.apigoto.com/v1",
api_key="sk-rouertcode-你的密钥",
)
response = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)
import OpenAI from 'openai'
const client = new OpenAI({
baseURL: 'https://www.apigoto.com/v1',
apiKey: process.env.APIGOTO_API_KEY,
})
const res = await client.chat.completions.create({
model: 'claude-sonnet-5',
messages: [{ role: 'user', content: '你好' }],
})
console.log(res.choices[0].message.content)
支持的协议与端点
网关同时挂着四套主流协议。选哪一套只取决于你手上的 SDK / 客户端,与实际调用的模型属于哪家厂商无关—— 跨协议的请求会由网关自动转换。
| 协议 | 端点 | 典型使用方 | 文档 |
|---|---|---|---|
| OpenAI Chat Completions | POST /v1/chat/completions | openai SDK、绝大多数三方应用 | 查看 |
| OpenAI Responses | POST /v1/responses | Codex CLI / Codex Desktop | 查看 |
| Anthropic Messages | POST /v1/messages | anthropic SDK、Claude Code | 查看 |
| Gemini 原生 | POST /v1beta/models/{model}:generateContent | google-genai SDK | 查看 |
| OpenAI Images | POST /v1/images/generations | 图片生成 / 编辑 | 查看 |
不确定该用哪一个?读 协议与端点选择。
调用之前需要知道的三件事
账号要能计费
网关在放行请求前会依次检查 BYOK 凭证、生效中的订阅、API 扣费余额。三者皆无时返回
403 / 40202。详见 计费、积分与订阅。
限流是多维度的
并发、RPM、RPH、RPD、TPM 各自独立判定,任一维度超出即返回 429 并附带
Retry-After。详见 限流、配额与并发。
网关自身产生的错误统一返回 code 字段(5 位数字:HTTP 状态 + 2 位序号),
上游厂商的错误则原样透传。看到不认识的码,直接查 错误码总表。
文档地图
开始使用
API 指南
流式响应 (SSE)
各协议流式事件格式与断流处理。
错误处理与重试
哪些错误可重试、如何退避。
限流、配额与并发
五个维度的判定顺序与响应头。
计费、积分与订阅
BYOK > 订阅 > API 扣费三级链路。
模型、准入与回退
模型 ID 从哪来、谁能用哪些模型。
客户端接入
Claude Code、Codex CLI、Cursor 配置。
API 文档
Chat Completions
覆盖面最广的通用对话端点。
Responses
OpenAI Responses 协议。
Messages
Anthropic 原生协议。
Gemini generateContent
Gemini 原生协议与流式变体。
Images 图片生成
生成与编辑两个端点。
平台管理 API
模型列表、定价、密钥管理。