透過的なルーティングとフライト内訳

GetVibe は透過的なルーターです。:alias サフィックスで公開バリアントを明示的に選ぶか、サフィックスなしのモデル名を指定すると、ゲートウェイがアカウント/キー戦略に従ってルートを選択し、失敗時には利用可能な別のバリアントに切り替えます。レスポンスと履歴では公開ルート識別子のみが使用されます。

"model": "claude-opus-4.8"          // auto — key strategy
"model": "claude-opus-4.8:yellow"   // pin — :yellow only, no switching to other channels
"model": "claude-opus-4.8:2"        // pin — catalog variant #2 (legacy :N syntax)

各モデルは異なる価格の複数のチャネルによって提供されます — いわばはしごです。この 2 つのリクエストボディパラメータは、そのはしごのどの段があなたにサービスを提供できるかを指定します。どちらもUSD per 1M tokensで、Modelsページに表示される単位と数値と同じです。これらは当社の価格 — 実際に請求される金額 — と比較され、あなたには見えない卸売価格と比較されることはありません。

{
  "model": "deepseek-v4-flash-0731",
  "messages": [{"role": "user", "content": "hi"}],
  "max_price": 0.02,
  "min_price": {"input": 0.001}
}

両方のレッグが収まる必要があります。入力と出力の両方であり、その平均ではありません。入力が安く出力が高いチャネルは、単一の数値による上限を満たしません。

常設の上限で、cabinet で一度だけ設定します

上限は毎回の呼び出しで繰り返す必要はありません。ダッシュボードは API キーごとおよびモデルごとに 1 つずつ保存し、さらに明示的に設定していないすべてのモデルを対象とするデフォルトも保存します。API は毎回のリクエストでこれを読み取ります。max_price を含むリクエストはその 1 回の呼び出しに対してその値を使用し、何も含まないリクエストは保存された上限を使用します。優先順位は、より具体的なものが先です：

上限設定の基準となる価格はどこで確認できますか？

GET /api/catalog はすべてのモデルについて channels 配列を公開します。リクエストが到達しうるチャネルごとに1エントリで、安い順に並び、それぞれに固定に使えるアドレス、100万トークンあたりの inputUsd / outputUsd 価格、およびそれがデフォルトかどうかが含まれます。これらは max_price と min_price が比較される正確な数値であり、あなたに請求される正確な数値でもあります — 1つのリストであり、3つではありません。

curl -s https://getvibeapi.com/api/catalog   | jq '.[] | select(.apiModel=="z-ai/glm-5.3") | .channels'

課金対象

課金されるのは実際にリクエストを処理したチャネルと、当社の固定マークアップです — 設定した上限額ではなく、上限額を超えることもありません。ある価格で上限を設定し、リクエストがより安い段で成立した場合は、その安い方の価格を支払います。モデルページのラダーは範囲を示しており、「from」の金額は存在する最も安い段です — これは実際に請求されうる価格であり、このリクエストがそこに収まるという約束ではありません。上限を保証する必要がある場合は max_price を設定してください。

何も収まらない場合

リクエストは 拒否 されます。HTTP 422 と "type": "price_bound_no_lane" を返し、そのモデルの最安チャネル価格と最高チャネル価格、および channels の完全なリストを提示します。これにより、上限を推測するのではなく数値から選べます。lowest_passing_usd_per_million は現在チャネルを許容する最小の上限です — 1つのチャネル自身のペアであるため、それを送信すれば通過します(2つの cheapest レッグは別々のチャネルから来る場合があります)。同じフィールドは、取引所自体が上限を拒否した場合にも現れます。その場合は、まだ供給のある次の価格レベルとなり、送信した上限を下回ることはありません。上限が 制限ではなかった 場合 — チャネルに対する当社自身の購入上限が制限であり、その下のオファーがビジーまたは枯渇していた場合 — の応答は代わりに HTTP 503 "type": "no_seller_available" と Retry-After になり、推奨価格は付きません。max_price を引き上げても効果はなく、まもなく再試行すれば効果があるかもしれません。最安の段にはビジーの単一オファーしかないことが多いため、確実に約定させるには、供給の大半が存在するモデルの priceTypical 以上に上限を設定してください。当社がより高価なチャネルを黙って提供することはなく、別のモデルに差し替えることもありません。不正な値 — 文字列、ゼロ、負の値、不明なフィールド — は 400 invalid_request_error となり、黙って無視されることはありません。

{
  "error": {
    "message": "No channel of model "deepseek-v4-flash-0731" is priced within your max_price $0.0001 in / $0.0001 out...",
    "type": "price_bound_no_lane",
    "code": 422,
    "param": "max_price",
    "cheapest_usd_per_million": {"input": 0.0065, "output": 0.013},
    "dearest_usd_per_million": {"input": 0.0528, "output": 0.1584},
    "lowest_passing_usd_per_million": {"input": 0.0205, "output": 0.0613},
    "channels": [
      {"address": "deepseek/deepseek-v4-flash-0731:codebuddy-cn", "label": "codebuddy-cn", "inputUsd": 0.0205, "outputUsd": 0.0613, "isDefault": true},
      {"address": "deepseek/deepseek-v4-flash-0731:qwencloud", "label": "qwencloud", "inputUsd": 0.0378, "outputUsd": 0.1132, "isDefault": false}
    ]
  }
}

ベンダーサブスクリプションプールから提供されるチャネルは、名前で指定できます。コロンの後に名前を、他のエイリアスとまったく同じように記述します:

"model": "gpt-6.1-sol:codex"         // pin a subscription pool
"model": "claude-opus-5.5:claude-code"  // pin the Claude Code pool

コロンの後のサフィックスは 公開 ルートの識別子であり、上流の名前ではありません。特定のモデルの完全なリストはカタログ(Models、「In API」列)にあります。主なエイリアス:

auto リクエスト（モデル名のみ）では、以下が各 API キー（ダッシュボード → API keys）に設定されます。

コロンの後にプロバイダーのエイリアスを追加します。これはルーティング戦略に関係なく適用されます。エイリアスの完全な一覧と例は、Models → Providers セクションにあります。

"model": "claude-opus-4.8"        // auto — key strategy
"model": "claude-opus-4.8:yellow"     // explicitly pin the :yellow channel
"model": "claude-opus-4.8:kiro-pool"  // explicitly pin the :kiro-pool channel

API キーごとに、ダッシュボードで設定できます:

ベアモデル を指定すると、現在のバリアントが 429、5xx、または内容のない空の 200 を返した場合に、ゲートウェイが同じモデルの別の公開バリアントに切り替えることがあります。制約:

• 画像/PDF を含むリクエストは別のプロバイダーに切り替えられません（ビジョン互換性）。
• フェイルオーバーは、大幅に高価なバリアントには移行しません（strategy=price の場合を除く）。
• クライアントリクエストあたりの試行回数には上限があります。
• pin（:alias）を指定すると、プロバイダー間のフェイルオーバーは オフ になり、選択したルートのエラーが返ります。

429 に対する指数バックオフでの再試行については、Errors and limits で説明しています。

信頼されたreveal/debugクライアントでは、リクエスト完了後(autoを含む)、実際に実行されたpublicバリアントを示すヘッダーが利用できます。通常のクライアントにはこのデータは提供されません。

信頼された reveal/debug クライアント用のレスポンスヘッダー（chat / messages / responses）

curl -sD - https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"ping"}],"max_tokens":8}' \
  -o /dev/null | grep -i getvibe

# x-getvibe-route: yellow
# x-getvibe-model: gpt-6.1-sol:yellow

使用履歴

GET /v1/generations、GET /v1/usage、およびダッシュボードでは、各レコードに以下のフィールドがあります：

GetVibe は、リクエスト本文でアップストリームプロバイダーを列挙する「raw」ウォーターフォールを提供していません。制御は公開の :alias、キー戦略、およびモデルカタログ内の自動フェイルオーバーによって行います。「プロバイダーを無視する」専用の API やルーティング ZDR フラグはありません。