モデル

GetVibe API のモデルリストと、model フィールドでのモデルの指定方法。:network、:nexus、:sub5 サフィックスによるルートバリアント — ルート、価格、キャッシュの挙動が異なります。

model フィールドには正確なモデル名を指定します。価格とキャッシュ対応を含む完全なリストはカタログページにあります。

ID は vendor/model（OpenRouter 形式）を使用します。例：anthropic/claude-opus-5。claude-opus-5 は入力エイリアスとして受け付けられ、課金は同一です。
model:alias はチャネルを固定します（例：openai/gpt-5.6-sol:yellow）。GET /v1/models はモデルごとに1つの ID を一覧表示し、?variants=1 は完全なリストを返します。

リクエストの課金方法

ほとんどのチャネルはマーケットプレイス・ブックです。多くの出品者が同じモデルを異なる価格で提供しています。リクエストはそれを受け入れる最も安いオファーで成立し、請求額はその成立コストに当社の手数料を加えたものになります。したがってトークンあたりの料金は単一の数値ではなく範囲となり、ブックのどのランクで成立したかによって決まります。

GET /api/catalog と GET /v1/pricing は、その範囲をモデルごと（pricing）およびチャネルごと（channels[]）に公開しており、同じラダー GET /api/model-ladder?model=<model> がオファー数とともに提供するものから読み取られます。

GEThttps://getvibeapi.com/api/model-ladder?model=claude-opus-5.5

価格フィールド（100万トークンあたりのUSD）

パラメーター	タイプ	説明
`basis`	"fill" \| "fixed" \| "mixed"	"fill"：充足した段階の料金に手数料を加えて請求されます。"fixed"：表示された料金で請求されます（from = typical = to）。"mixed"（モデルレベルのみ）：各種類のチャネルが混在しています。
`priceFrom`	{input, output}	最も安い段階です。リクエストに請求されうる最低レートです。
`priceTypical`	{input, output}	オファーで重み付けした中央値の段階です。ブック上のオファーの半数がこの値以下となります。これは供給がどこにあるかを示すものであり、次に約定する価格の予測ではありません。モデルレベルではデフォルトチャネルの値です。
`priceTo`	{input, output}	ブック上で最も高い段階です。max_price なしのリクエストに請求されうる最高額です。
`pool`	string \| null	Channelのみ。チャネルが買い付けを行うブックを、ラダーが出力するとおりに示します。各プールは正確に1つのチャネルとして公開されます。
`maxPriceCeiling`	{input, output} \| null	Channelのみ。リクエストにmax_priceが含まれる場合、このチャネルはmax_priceとこの上限の低い方を超えて成立することはありません。max_priceがない場合、上限は送信されません。
`minChargePerRequest`	number	1Mあたりではなく、リクエストあたりのUSDです。サプライヤーがリクエストごとの最低額を課金するチャネル（サプライヤールール）にのみ表示されます。成功したリクエスト1回につき最低限課金される金額で、例えば$0.0000143です。トークンのコストがそれ未満になるリクエスト — 短いものや、ほとんどがキャッシュ読み取りのもの — はこの金額で課金されます。モデルレベル（nullable）では、デフォルトチャネルの値になります。
`fill`	{"24h", "7d"} \| null	Channelのみ(および/api/model-ladderの各サービスプール上)。このチャネルでの有料リクエストが実際にどのように成立したか:各ラングごとにリクエストの割合とトークンの割合、avgPriceはトークン加重の平均支払額(実際に支払う典型的な価格)、そして本日のラダーを下回る価格または上回る価格で成立した割合(ブックは動きます)、またはリクエストごとの最低額で課金された割合です。リクエストが20件未満のウィンドウではnullです。
`ladder`	string	モデルのみ。/api/model-ladder URLには完全なランク一覧とオファー数が含まれます。
`inputUsd / outputUsd`	number	互換性のために保持されています。fillチャネルではpriceFromと等しくなります。これは固定価格ではなく下限です。

"pricing": {
  "basis": "fill",
  "unit": "USD per 1M tokens",
  "priceFrom":    { "input": 0.465, "output": 2.325 },
  "priceTypical": { "input": 0.5,   "output": 2.5 },
  "priceTo":      { "input": 1.5,   "output": 7.5 },
  "minChargePerRequest": 0.0000125,
  "ladder": "/api/model-ladder?model=claude-opus-5.5",
  "ladderUpdatedAt": "2026-09-25T08:45:01.522Z",
  "ladderStale": false
},
"channels": [
  { "address": "claude-opus-5.5:claude-code", "isDefault": true,
    "inputUsd": 0.465, "outputUsd": 2.325,
    "basis": "fill", "pool": "cc/claude-opus-5-5",
    "priceFrom": { "input": 0.465, "output": 2.325 },
    "priceTypical": { "input": 0.5, "output": 2.5 },
    "priceTo": { "input": 1.5, "output": 7.5 },
    "maxPriceCeiling": { "input": 0.6, "output": 3 },
    "minChargePerRequest": 0.0000125 }
]

プールは 1 つのチャネルと 1 つの価格ラダーです — たとえば claude-code：リクエストはそれを受け入れる段で満たされ、priceFrom から priceTo の間になります。リクエストにかかるコストを上限設定するには、max_price を送信してください — これがなければラダーのどの段でも満たされる可能性があり、これがあればリクエストが上限を超えて満たされることはありません。価格の背後にある深さを見るにはラダーを読み、リクエストが実際にどこに着地するかを見るにはその fill を読みます。/v1/generations の各リクエストは cost_detail.realisedRate（課金された 100 万トークンあたりの価格）を持つため、ラダー上の位置を特定できます。成功したすべてのリクエストには少なくともチャネルの minChargePerRequest がかかるため、非常に小さいリクエストやほとんどキャッシュされたリクエストは、トークンあたりの金額ではなくその最低金額が請求されます。

1 つのモデルのバリアント

ほとんどのモデルには複数の公開バリアントがあります。デフォルトのバリアントは自動的に選択されます (優先順位はアカウントまたはキーの設定に従います)。リクエストで特定のバリアントを固定するには、モデル名の後にコロンを付けてそのエイリアスを追加します:

"model": "gpt-6.1-sol"           // default variant (auto)
"model": "gpt-6.1-sol:yellow"    // explicit public variant
"model": "claude-opus-5.5"     // use an id from the catalog

明示的なバリアントを指定したリクエスト例:

curl https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8:yellow",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
# :yellow — pin a public variant for this request

バリアントエイリアス

カタログのエイリアスのみを使用してください。利用可能なサフィックス:

パラメーター	タイプ	説明
`:yellow`	suffix	パブリックバリアント。可用性と価格はモデルによって異なります。
`:codex / :claude-code`	suffix	サブスクリプションプールです。各プールが提供するモデルはカタログに記載されています。
`:pixel`	suffix	メディアモデル向けのパブリックバリアント。

各モデルの正確なサフィックスはModelsページの「In API」列で確認してください。実際に利用可能なバリアントのみがそこに表示されます。利用できないサフィックスを渡すと、リクエストは400を返します。

API でモデルを一覧表示する

利用可能なモデル ID の完全なリストはプログラムから取得できます:

GEThttps://getvibeapi.com/v1/models

curl https://getvibeapi.com/v1/models \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

id/object/created/owned_byに加えて、すべてのエントリはtype（chat、embedding、rerank、image、video、audio、music、3d）、architecture.input_modalities / output_modalities、およびendpointsを保持します — これはそのモデルに対してリクエストを送信する場所です。

デフォルトのリストにはチャット、埋め込み、リランクのモデルのみが含まれるため、IDE のモデルピッカーがチャットできないモデルを提示することはありません。
メディアモデル (画像、動画、音声、音楽、3D) はリクエストに応じて一覧表示されます: ?type=image (またはリスト: ?type=image,video)、?output_modalities=image。?modality= と ?category= は type の同義語です。
すべてを一度に: ?all=true、?type=all または GET /v1/models/all。メディアはそのバリアント (model:alias) とともに一覧表示されます — 送信する正確な id です。
GET /v1/models/{id} は1つのモデルを返します。不明な id は code: "model_not_found" 付きの 404 となります。

curl "https://getvibeapi.com/v1/models?type=image,video" \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

カタログの更新を購読する（RSSおよびJSON Feed）

カタログに追加されたすべてのモデルと新着情報の投稿は、キー不要の公開フィードで配信されます。RSS リーダーやエージェントから読み取ることができ、エージェントはモデルの変化に合わせてアプローチを変更できます。フィードには全履歴がページごとに保存され、各イベントにはエージェントがすぐにモデルを呼び出すために必要な情報が含まれています。

/rss.xml（別名 /feed.xml）は RSS 2.0 です。/feed.json は JSON Feed 1.1 で、フィードレベルの _meta ブロックとイベントごとの _catalog ブロックがあります。
ページ：各ページは 50 イベントで、?limit= は最大 100 まで指定でき、新しい順に並びます。次の（古い）ページは、JSON Feed では next_url、RSS では <atom:link rel="next"> です（RFC 5005 に準拠し、rel="first" と rel="previous" も含まれます）。リンクにはカーソルが含まれるため、ページをたどっている間にモデルが公開されても、すでに読んだイベントの位置がずれることはありません。返されたリンクをそのまま使用してください。
フィルター：?kind=text|image|video|audio|music|3d|news と ?since=YYYY-MM-DD — 指定した UTC 日付以降（当日を含む）のイベントのみを取得します。フィルターはページングと併用でき、リンク内に保持されます。
model_added イベントには、タイトル、モデルがカタログに登場した日付、モデルページへのリンク、説明に加え、_catalog に次の情報が含まれます。model として送信する公開 ID（:alias のルート表記やサプライヤー名は含みません）、エンドポイント、入力と出力のモダリティ、コンテキストウィンドウと最大出力、機能（ツール、JSON / 構造化出力、画像認識、推論とそのレベル、キャッシュ）、単位付きの USD 建て公開開始価格、メディアの場合はすべてのリクエストパラメータとその許容値、すぐに使えるリクエスト（curl と JSON）、ドキュメントへのリンクです。news イベントは新着情報の投稿です。
イベントの guid は変わりません。フィードには生成結果の記録はなく、サンプルリクエストのみが含まれます。
ポーリングの頻度は、多くても数分に 1 回にしてください。各ページには固有の ETag と Last-Modified があります。If-None-Match / If-Modified-Since を送信すると、変更のないページは本文なしの 304 を返します。新着分のみを取得するには、最後に処理したイベントの日付を記録し、その日付を指定して ?since= をリクエストしてください。

curl -sS "https://getvibeapi.com/feed.json?since=2026-10-01&limit=100"
curl -sS -i https://getvibeapi.com/feed.json -H 'If-None-Match: "<ETag from the previous response>"'   # -> 304

← 前へ関数呼び出し次へ →Vision（チャット内の画像）