模型

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 会列出每个模型对应的一个 ID；?variants=1 会返回完整列表。

请求如何计费

大多数渠道都是市场报价簿：许多卖家以不同价格提供同一模型。你的请求会以能够接单的最低价报价成交，计费金额为该成交价格加上我们的佣金。因此，每 token 费率是一个范围，而不是单一数字，具体取决于报价簿中的哪一级报价成交。

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

定价字段（每 1M tokens 的 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	仅限通道。该通道购买服务的价格表，以阶梯形式展示。每个池恰好作为一个通道发布。
`maxPriceCeiling`	{input, output} \| null	仅限通道。当请求携带 max_price 时，该通道不会以高于 max_price 和此上限两者中较低者的价格完成请求。不带 max_price 时不会发送上限。
`minChargePerRequest`	number	每个 REQUEST 的 USD 价格，而不是每 1M 的价格。仅在供应商按请求收取最低费用的渠道上显示（供应商规则）：至少一个成功请求会计费，例如 $0.0000143。令牌成本低于此金额的请求（例如较短的请求，或主要是缓存读取的请求）将按此金额计费。在模型级别（可为 null）时，它是默认渠道的价格。
`fill`	{"24h", "7d"} \| null	仅限通道（以及 /api/model-ladder 中提供服务的每个池）。该通道上的付费请求实际完成时：按每个梯级统计请求份额和 token 份额；avgPrice 表示按 token 加权的实际平均支付价格，即你通常实际支付的价格；还统计低于或高于今日阶梯价格（价格表会变动）完成的请求份额，以及按每请求最低费用计费的请求份额。请求数少于 20 的时间窗口返回 null。
`ladder`	string	仅模型。包含完整阶梯列表和报价数量的 /api/model-ladder URL。
`inputUsd / outputUsd`	number	为保持兼容性而保留。在 fill channel 上，它们等于 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 }
]

pool 是一个带有单一价格阶梯的 channel，例如 claude-code：请求会在能够处理它的任一档位成交，价格介于 priceFrom 和 priceTo 之间。要限制请求的最高费用，请发送 max_price；不发送时，阶梯中的任一档位都可能处理请求，发送后请求永远不会以高于该上限的价格成交。要查看某个价格背后的深度，请读取价格阶梯；要查看请求实际落在哪个档位，请读取其 fill。/v1/generations 中的每个请求都包含 cost_detail.realisedRate，即该请求实际计费的每 1M 价格，因此你可以将其定位到价格阶梯上。每个成功请求的费用至少为该 channel 的 minChargePerRequest，因此非常小或大部分来自缓存的请求会按该最低费用计费，而不是按 token 数量计算的费用计费。

同一模型的变体

大多数模型都有多个公开变体。系统会自动选择默认变体（优先级遵循你的账户或密钥设置）。要为请求固定使用特定变体，请在模型名称后加上冒号和该变体的别名：

"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	公共 variant；可用性和价格取决于模型。
`:codex / :claude-code`	suffix	订阅池；每个池支持的模型见目录。
`:pixel`	suffix	媒体模型的公共 variant。

在 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} 返回一个模型；未知 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 永远不会改变。Feed 不会记录生成结果，只有一个示例请求。
轮询频率最高为每几分钟一次：每一页都有自己的 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

← 上一页函数调用下一页 →视觉（聊天中的图像）