跳轉到主要內容

快速答案

一句話記住: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易 提供 3 個域名節點,功能完全一致,區別在於網路線路和部署架構:

🌏 預設節點(推薦)

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 秒,請使用 api.apiyi.com(或備用節點 b.apiyi.com)。
建議在程式碼中配置備用節點,實現自動切換,提高服務可用性。

常見報錯排查

完整配置速查

OpenAI 相容模型

Claude 模型(Anthropic SDK)

Gemini 模型

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