クイックアンサー
覚えておいてください: 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 は、機能が同一で、ネットワークルーティングとデプロイメントアーキテクチャが異なる 4 つのドメインノードを提供します:🌏 グローバルダイレクト(海外向け推奨)
vip.apiyi.comバックエンドへ直接接続し、レイテンシーが最小です。中国本土以外のお客様に推奨します。🇨🇳 中国デフォルト(中国本土向け推奨)
api.apiyi.com中国本土ネットワーク向けに最適化されています。中国本土のお客様のデフォルトです。🏢 中国バックアップ / ビジネス
b.apiyi.comバックアップノードとビジネス向けエンタープライズ回線です。プライマリノードが利用できない場合に使用します。⚡ Cloudflare CDN グローバルアクセラレーション
api-cf.apiyi.comCloudflare のグローバル CDN アクセラレーションです。テキストのみの API 呼び出しに使用します。100秒のタイムアウト制限があります。よくあるエラーのトラブルシューティング
完全設定リファレンス
OpenAI 互換モデル
Claude モデル(Anthropic SDK)
Gemini モデル
Google GenAI SDK を Gemini に使用する場合は、
base_url をルートドメインに設定し、api_version: "v1beta" を設定してください。SDK が完全なパスを自動的に構築します。