APIGOTO API 文档

APIGOTO 是一个统一的大模型 API 网关。它把 OpenAI、Anthropic、Google 等厂商的原生协议收敛到同一个 Base URL 与同一把 API Key 之下——你不需要为每家厂商各写一套客户端,也不需要各自申请、各自续费。

接入方式

APIGOTO 的对外接口与各厂商官方协议保持字段级兼容。你继续用官方 SDK,只需要替换两个值: base_urlapi_key。请求体、响应体、流式事件都由网关原样透传上游,不做结构改写。

BASE URL https://www.apigoto.com/v1 点击复制
hello.sh
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": "你好"}]
  }'

支持的协议与端点

网关同时挂着四套主流协议。选哪一套只取决于你手上的 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。详见 计费、积分与订阅

模型要对你可见

部分模型限定认证等级或套餐等级,不满足时返回 40203。可调用模型清单以 模型列表接口 的返回为准,规则见 模型、准入与回退

限流是多维度的

并发、RPM、RPH、RPD、TPM 各自独立判定,任一维度超出即返回 429 并附带 Retry-After。详见 限流、配额与并发

💡
错误码是排查的第一入口

网关自身产生的错误统一返回 code 字段(5 位数字:HTTP 状态 + 2 位序号), 上游厂商的错误则原样透传。看到不认识的码,直接查 错误码总表

文档地图

开始使用

API 指南

API 文档

参考