メインコンテンツへスキップ

クイックアンサー

覚えておいてください: 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は同一の機能を備えた3つのドメインノードを提供しており、ネットワークルーティングとデプロイアーキテクチャが異なります:

🌏 デフォルト(推奨)

api.apiyi.comデフォルトのメイン回線です。中国本土内外を問わず、すべてのお客様に推奨されます。

🏢 中国バックアップ / Business

b.apiyi.comバックアップノードおよびBusinessエンタープライズ回線です。プライマリノードが利用できない場合に使用してください。

⚡ Cloudflare CDN グローバル高速化

api-cf.apiyi.comCloudflareのグローバルCDN高速化です。テキストのみのAPI呼び出し向けです。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が自動的に完全なパスを構築します。