モデル ID

RouteAPI モデル ID は、アプリケーションが model フィールドに指定する名前です。これは業務システムと RouteAPI の間で共有される公開の取り決めです。

安定したモデル ID が必要な理由

• プラットフォーム側でモデルの可用性を調整しても、アプリケーションコードを頻繁に変更する必要がありません。
• チームは承認済みのモデル名セットを統一して使用できます。
• ログ、課金、アラートが読みやすくなります。
• SDK やツールごとのクライアント設定がシンプルになります。

例

{
  "model": "gpt-4o",
  "messages": [
    { "role": "user", "content": "このドキュメントを要約してください。" }
  ]
}

model の値は、RouteAPI コンソールで現在のアカウントが利用できるモデル ID と一致している必要があります。

ベストプラクティス

• コンソールに表示されるモデル ID を使用し、本番環境で一時的な名前をハードコードしないでください。
• 品質、レイテンシ、コストの期待値が異なる場合は、それぞれ別のモデル ID を用意します。
• 本番フローで使用する前に、モデルの挙動を検証します。
• 高トラフィックのアプリケーションでモデル ID を変更した後は、使用量ログで効果を確認します。