文档

Base URL

AIGoCode 各兼容协议和常见客户端的服务地址

AIGoCode 的统一服务根地址是:

https://api.aigocode.dev

不同接入方式对 Base URL 的填写方式略有不同。

SDK 地址与请求路径

使用方式SDK 或客户端填写地址HTTP 请求路径示例
OpenAI 官方 SDKhttps://api.aigocode.dev/v1/v1/responses 或 /v1/chat/completions
Anthropic 官方 SDKhttps://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 FoundBase URL 多填或少填了 /v1、/v1beta
401 UnauthorizedAPI Key、分组或该协议要求的认证字段不匹配
Gemini 请求失败Gemini 兼容协议通常需要 /v1beta

下一步阅读 第一次请求。

本页目录