快速答案
一句話記住: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 會自動拼接完整路徑。