文档
Base URL
AIGoCode 各兼容协议和常见客户端的服务地址
AIGoCode 的统一服务根地址是:
https://api.aigocode.dev不同接入方式对 Base URL 的填写方式略有不同。
SDK 地址与请求路径
| 使用方式 | SDK 或客户端填写地址 | HTTP 请求路径示例 |
|---|---|---|
| OpenAI 官方 SDK | https://api.aigocode.dev/v1 | /v1/responses 或 /v1/chat/completions |
| Anthropic 官方 SDK | https://api.aigocode.dev | /v1/messages |
| Gemini 客户端 | 按客户端要求填写根地址或 https://api.aigocode.dev/v1beta | /v1beta/models/{model}:generateContent |
直接发送 HTTP 请求时,将服务根地址与请求路径组合成完整地址;使用 SDK 时,让 SDK 按其规则拼接路径。
工具地址
很多 CLI 或桌面客户端会自己拼接 /v1、/v1beta 或具体 endpoint。遇到这类工具时,通常只填根地址:
https://api.aigocode.dev例如 Claude Code、Codex、Cherry Studio、OpenCode、OpenClaw、Hermes 的教程里都会明确写该填根地址还是协议地址。
排查
| 现象 | 常见原因 |
|---|---|
404 Not Found | Base URL 多填或少填了 /v1、/v1beta |
401 Unauthorized | API Key、分组或该协议要求的认证字段不匹配 |
| Gemini 请求失败 | Gemini 兼容协议通常需要 /v1beta |
下一步阅读 第一次请求。

