モデル自動ルーティング（Auto Router）

たった一つの model=auto で、「どのモデルを選ぶか」をゲートウェイに任せましょう。

​

ユースケース

• 汎用アプリ：ユーザーがどんなタイプのリクエストを送ってくるか分からないとき、内容に応じた振り分けを auto に任せられます。
• コスト最適化：簡単なタスクを自動的により安く、より速いモデルに割り当てます（auto はデフォルトでコスト優先）。
• 品質最適化：複雑なリクエストを、より能力の高いモデルへ確実にルーティングします（auto:quality_first）。
• 低レイテンシ用途：リアルタイム音声や agent の多段ループでは、最も応答が速いモデルを優先します（auto:latency_critical）。
• 統一エントリ・モデル選定不要：異なるタイプのリクエストを自動的にそれぞれ最適なモデルへ振り分け——「タスク → モデル」の対応表を保守する必要も、モデルの更新を追いかけて手動で価格比較やモデル名の差し替えをする必要もありません。

​

クイックスタート

curl https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer <AIHUBMIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [
      { "role": "user", "content": "What is the meaning of life?" }
    ]
  }'

​

実際にヒットしたモデルの確認方法

• 応答ボディの model フィールドには、auto ではなく実際にヒットしたモデル（例：mimo-v2.5-pro）が書き戻されます。
• 応答ヘッダーには完全な決定情報が含まれます：

HTTP 応答ヘッダーは大文字小文字を区別しません：上表では慣例的に頭文字を大文字にしていますが、実際の HTTP/2 の返却は小文字の x-aihubmix-router-* であり、両者は等価です。

curl -i https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer <AIHUBMIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [
      { "role": "user", "content": "What is the meaning of life?" }
    ]
  }' | grep -i "^x-aihubmix-router"

x-aihubmix-router-decision-id: 05dbad09-33c5-42de-85b5-559fdb73eb4c
x-aihubmix-router-dimension: text.overall
x-aihubmix-router-policy: cost_optimized
x-aihubmix-router-reason: policy=cost_optimized dim=text.overall top=0.182 survivors=20/33
x-aihubmix-router-resolved-model: xiaomi-mimo-v2.5-pro

​

ルーティングポリシー

# 品質優先 + コーディングタスク
curl -i https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer <AIHUBMIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto:quality_first",
    "messages": [
      { "role": "user", "content": "Write a Python function to reverse a linked list." }
    ]
  }' | grep -i "^x-aihubmix-router"

latency_critical は**-think 版ではない**ものを選びました——thinking バリアントは推論のレイテンシが高く、低レイテンシポリシーはこれを積極的に避けます。ポリシーの重み付けが「能力 / コスト / レイテンシ」のトレードオフに実際に作用しており、能力だけを見ているのではないことが分かります。

内容も結果を変えます：同じ auto:quality_first をコーディングタスク（上の例のリクエスト）に使うと、次元は text.overall から text.coding に変わり、実測では claude-opus-4-6-think がヒットしました——ポリシーとリクエスト内容が共同で最終的なモデルを決定します。

​

仕組み

claude-fable-5 の能力スコアが最も高い（1510）にもかかわらず、コストが高くレイテンシも大きいために総合スコアで 3 位に押し下げられている点に注目してください。これこそが重み付けスコアリングの意義です：「能力至上主義」ではなく、ポリシーに従って能力 / コスト / レイテンシの間でトレードオフを取っているのです。

​

信頼性とフォールトトレランス

​

課金について

​

制限事項

• 自動ルーティングは現在チャット補完インターフェース /v1/chat/completions を対象としています（詳細は FAQ：対応しているインターフェース を参照）。
• ?router=off またはリクエストヘッダー X-Router-Off は、model=auto に対して直接 400 を返します——これは「auto を使いたいがルーティングはオフにしたい」という曖昧な使い方を黙って無視するのではなく、明確に拒否するものです：
  curl -i "https://aihubmix.com/v1/chat/completions?router=off" \
    -H "Authorization: Bearer <AIHUBMIX_API_KEY>" \
    -H "Content-Type: application/json" \
    -d '{"model":"auto","messages":[{"role":"user","content":"hi"}]}'
  # → HTTP/1.1 400 Bad Request
  # {"error":{"message":"auto requires router enabled; remove ?router=off / X-Router-Off", ...}}
  
• 候補の集合はプラットフォームの catalog に応じて動的に変化します：同じ auto でも、時点が異なれば異なるモデルがヒットすることがあります（これは設計上の仕様であり、応答ヘッダーで後から検証できます）。

​

OpenRouter / LiteLLM との違い

​

よくある質問 FAQ

​

関連リソース

• モデルマッピングとフォールバック：Key レベルの固定エイリアス + 失敗時フォールバックで、自動ルーティングを補完します。
• 統一推論パラメータ：モデルをまたいで一貫したリクエストパラメータ。
• AIHubMix モデルページ：モデル名・価格・Input Modalities を確認できます。