Skip to main content

クイックアンサー

覚えておいてください: 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)

Claude ユーザーによくある間違い: 公式 Anthropic SDK を使う場合、Base URL は https://api.apiyi.com のみを指定してください。/v1 は追加しないでください。ただし、OpenAI SDK の互換モードで Claude を呼び出す場合は、/v1 が必要です。

ドメインノードの選択

APIYI は、機能が同一で、ネットワークルーティングとデプロイメントアーキテクチャが異なる 4 つのドメインノードを提供します:

🌏 グローバルダイレクト(海外向け推奨)

vip.apiyi.comバックエンドへ直接接続し、レイテンシーが最小です。中国本土以外のお客様に推奨します

🇨🇳 中国デフォルト(中国本土向け推奨)

api.apiyi.com中国本土ネットワーク向けに最適化されています。中国本土のお客様のデフォルトです

🏢 中国バックアップ / ビジネス

b.apiyi.comバックアップノードとビジネス向けエンタープライズ回線です。プライマリノードが利用できない場合に使用します。

⚡ Cloudflare CDN グローバルアクセラレーション

api-cf.apiyi.comCloudflare のグローバル CDN アクセラレーションです。テキストのみの API 呼び出しに使用します。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 モデル

Google GenAI SDK を Gemini に使用する場合は、base_url をルートドメインに設定し、api_version: "v1beta" を設定してください。SDK が完全なパスを自動的に構築します。