快速答案
一句話記住: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易 提供 4 個域名節點,功能完全一致,區別在於網路線路和部署架構:🌏 全球直連(推薦海外客戶)
vip.apiyi.com直連大後端,延遲最低。全球客戶(非中國大陸)首選推薦。🇨🇳 國內預設(推薦大陸客戶)
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 會自動拼接完整路徑。