Skip to main content

快速答案

一句話記住: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)

Claude 使用者常見錯誤:如果你用 Anthropic 官方 SDK 呼叫 Claude,Base URL 只填 https://api.apiyi.com,千萬不要加 /v1。但如果你用 OpenAI SDK 的相容模式呼叫 Claude,則需要加 /v1

域名節點選擇

API易 提供 4 個域名節點,功能完全一致,區別在於網路線路和部署架構:

🌏 全球直連(推薦海外客戶)

vip.apiyi.com直連大後端,延遲最低。全球客戶(非中國大陸)首選推薦

🇨🇳 國內預設(推薦大陸客戶)

api.apiyi.com國內最佳化線路,中國大陸客戶預設推薦

🏢 國內備用 / 企業專用

b.apiyi.comBackup 備用節點,同時也是 Business 企業專用線路。主力節點異常時可切換。

⚡ Cloudflare CDN 全球加速

api-cf.apiyi.comCloudflare 全球 CDN 加速,適合純文本類呼叫。有 100 秒超時限制。
Cloudflare CDN 節點限制api-cf.apiyi.com 基於 Cloudflare Workers 部署,最大請求超時為 100 秒。因此:
  • 適合:普通文本對話、短文本生成等快速響應的呼叫
  • 不適合:超過 100 秒的複雜長文本任務
  • 不適合:Nano Banana Pro 等圖片生成任務
  • 不適合:影片生成 API 呼叫
如果你的任務可能超過 100 秒,請使用 vip.apiyi.com(海外)或 api.apiyi.com(國內)。
建議在程式碼中配置備用節點,實現自動切換,提高服務可用性。

常見報錯排查

完整配置速查

OpenAI 相容模型

Claude 模型(Anthropic SDK)

Gemini 模型

Gemini 使用 Google GenAI SDK 時,base_url 填根域名,同時設定 api_version: "v1beta",SDK 會自動拼接完整路徑。