クイックアンサー
覚えておいてください: OpenAIモデルには
/v1が必要で、Claudeはルートドメインのみを使用し、Geminiには/v1betaが必要です。Base URLの誤りは、最もよくある統合時の問題です。なぜモデルごとにベース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)
ドメインノードの選択
APIYIは同一の機能を備えた3つのドメインノードを提供しており、ネットワークルーティングとデプロイアーキテクチャが異なります:🌏 デフォルト(推奨)
api.apiyi.comデフォルトのメイン回線です。中国本土内外を問わず、すべてのお客様に推奨されます。🏢 中国バックアップ / Business
b.apiyi.comバックアップノードおよびBusinessエンタープライズ回線です。プライマリノードが利用できない場合に使用してください。⚡ Cloudflare CDN グローバル高速化
api-cf.apiyi.comCloudflareのグローバルCDN高速化です。テキストのみのAPI呼び出し向けです。100秒のタイムアウト制限があります。よくあるエラーのトラブルシューティング
完全な設定リファレンス
OpenAI互換モデル
Claudeモデル(Anthropic SDK)
Geminiモデル
Gemini用のGoogle GenAI SDKを使用する場合は、
base_urlをルートドメインに設定し、api_version: "v1beta" — SDKが自動的に完全なパスを構築します。