快速答案
一句话记住:OpenAI 系列加
/v1,Claude 只填根域名,Gemini 加 /v1beta。填错 Base URL 是最常见的接入问题。为什么不同模型的 Base URL 不一样?
这是由各厂商 SDK 的内部实现决定的:- OpenAI SDK:在
base_url后拼接资源路径,所以需要包含/v1 - Anthropic SDK:内部自动拼接
/v1/messages,如果你填了/v1会变成/v1/v1/messages,导致 404 错误 - Google GenAI SDK:使用
/v1beta路径,SDK 自动处理路径拼接
代码示例
OpenAI 兼容模型(GPT / DeepSeek / Llama 等)
Claude 模型(Anthropic SDK)
Gemini 模型(Google GenAI SDK)
域名节点选择
API易 提供 3 个域名节点,功能完全一致,区别在于网络线路和部署架构:🌏 默认节点(推荐)
api.apiyi.com默认主力线路,国内外客户均推荐使用。🏢 国内备用 / 企业专用
b.apiyi.comBackup 备用节点,同时也是 Business 企业专用线路。主力节点异常时可切换。⚡ Cloudflare CDN 全球加速
api-cf.apiyi.comCloudflare 全球 CDN 加速,适合纯文本类调用。有 100 秒超时限制。常见报错排查
完整配置速查
OpenAI 兼容模型
Claude 模型(Anthropic SDK)
Gemini 模型
Gemini 使用 Google GenAI SDK 时,
base_url 填根域名,同时设置 api_version: "v1beta",SDK 会自动拼接完整路径。