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

​
ルーティングの考え方

YouRouter には 自動 と 手動（固定） の 2 モードがあり、挙動は vendor ヘッダーで制御します。

​
デフォルト：自動ルーティング（auto）

可用性を最大化するなら自動ルーティングを推奨します。vendor を省略するか auto にします。 auto では、要求されたモデルに対して、可用性が高く費用効率のよいプロバイダーへインテリジェントにルーティングします。たとえば gpt-4o を要求したときに OpenAI API で遅延が発生している場合、Azure OpenAI など別プロバイダーへシームレスにフェイルオーバーし、リクエストが中断されないようにします。高可用性が重要な本番アプリケーションでは、この設定が推奨されます。

​
手動：プロバイダーを固定する

特定プロバイダーのモデルを使う必要がある場合や、プロバイダー固有機能へアクセスしたい場合は、手動でルーティングできます。その場合は、vendor ヘッダーに目的のプロバイダー ID を指定します。 例：Azure へ固定したい場合は vendor: azure を付けます。 
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["YOUROUTER_API_KEY"],
    base_url="https://api.yourouter.ai/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello from Azure OpenAI!"}],
    extra_headers={"vendor": "azure"}
)

print(response.choices[0].message.content)

​
利用可能なプロバイダー（例）

Providervendor 値
Anthropicanthropic
AWS Bedrockaws
Azure OpenAIazure
DeepSeekdeepseek
Googlegoogle
Mistral AImistral
OpenAIopenai
Volcenginevolcengine
xAIx

​
Zero Completion Insurance（ゼロ完了保険）

成功かつ非空の応答に対してのみ課金されます。500 などのエラーや completion token が 0 のケースでは課金されません。全リクエストでデフォルト有効です。

​
ベストプラクティス

  • 本番では auto を使う：稼働率が重要なアプリケーションでは、デフォルトの auto モードを強く推奨します。自動フェイルオーバーと高可用性ルーティングの恩恵を受けられます。
  • 固有要件がある場合だけ手動ルーティングする：特定プロバイダーに固有のモデルや機能が必要な場合に限り、vendor ヘッダーでプロバイダーを指定します。
  • プロバイダー固有ドキュメントを確認する：手動ルーティングで特殊機能を使う場合は、詳細なパラメータ情報を必ず元プロバイダーのドキュメントで確認してください。これらのパラメータは リクエスト転送 ガイドの通り、YouRouter 経由でそのまま渡せます。
詳細な API 例は Chat Completions を参照してください。