Modelos

O campo model recebe o nome exato do modelo. A lista completa, com preços e suporte a cache, está na página do catálogo.

• Os IDs usam vendor/model (no estilo do OpenRouter), por exemplo, anthropic/claude-opus-5; claude-opus-5 é aceito como um alias de entrada com cobrança idêntica.
• model:alias fixa um canal, por exemplo, openai/gpt-5.6-sol:yellow. GET /v1/models lista um ID por modelo; ?variants=1 retorna a lista completa.

A maioria dos canais são livros de marketplace: vários vendedores oferecem o mesmo modelo a preços diferentes. Sua solicitação é atendida pela oferta mais barata que a aceitar, e você paga o custo desse atendimento mais nossa comissão. Portanto, a tarifa por token é um intervalo, não um número único: ela depende de qual nível do livro foi preenchido.

GET /api/catalog e GET /v1/pricing publicam esse intervalo por modelo (pricing) e por canal (channels[]), lido da mesma escada GET /api/model-ladder?model=<model> que disponibiliza com suas contagens de ofertas.

"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 }
]

A maioria dos modelos tem várias variantes públicas. A variante padrão é escolhida automaticamente (a prioridade segue as configurações da sua conta ou chave). Para fixar uma variante específica em uma solicitação, adicione o alias dela após dois-pontos ao nome do modelo:

"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

Exemplo de solicitação com uma variante explícita:

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

Use apenas aliases do catálogo. Sufixos disponíveis:

Você pode obter programaticamente a lista completa de ids de modelos disponíveis:

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

Além de id/object/created/owned_by, cada entrada contém type (chat, embedding, rerank, image, video, audio, music, 3d), architecture.input_modalities / output_modalities e endpoints — para onde enviar uma solicitação para esse modelo.

• A lista padrão contém apenas modelos de chat, embedding e rerank, para que um seletor de modelos de IDE nunca ofereça um modelo que não possa conversar.
• Os modelos de mídia (imagem, vídeo, áudio, música, 3D) são listados mediante solicitação: ?type=image (ou uma lista: ?type=image,video), ?output_modalities=image; ?modality= e ?category= são sinônimos de type.
• Tudo de uma vez: ?all=true, ?type=all ou GET /v1/models/all. A mídia é listada junto com suas variantes (model:alias), exatamente o id a ser enviado.
• GET /v1/models/{id} retorna um modelo; um ID desconhecido resulta em 404 com code: "model_not_found".

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

Cada modelo adicionado ao catálogo e nossas publicações de novidades são publicados em um feed aberto — sem necessidade de chave. Leia-o em um leitor de RSS ou por meio de um agente, para que ele possa mudar sua abordagem conforme os modelos mudam. O feed contém todo o histórico, página por página, e cada evento traz o que um agente precisa para chamar o modelo imediatamente.

• /rss.xml (alias /feed.xml) é RSS 2.0; /feed.json é JSON Feed 1.1 com um bloco _meta no nível do feed e um bloco _catalog por evento.
• Páginas: 50 eventos cada, ?limit= até 100, dos mais recentes para os mais antigos. A próxima página (mais antiga) é next_url no JSON Feed e <atom:link rel="next"> no RSS (RFC 5005, também com rel="first" e rel="previous"). Os links contêm um cursor, de modo que um modelo publicado enquanto você percorre as páginas nunca desloca um evento que você já leu. Use os links conforme retornados.
• Filtros: ?kind=text|image|video|audio|music|3d|news e ?since=YYYY-MM-DD — somente eventos a partir desse dia em UTC, inclusive. Os filtros funcionam em conjunto com a paginação e são mantidos nos links.
• Um evento model_added traz o título, a data em que o modelo apareceu no catálogo, um link para a página do modelo, uma descrição e, em _catalog: os ids públicos para enviar como model (sem as formas de rota :alias e sem nomes de fornecedores), os endpoints, as modalidades de entrada e saída, a janela de contexto e o limite máximo de saída, os recursos (ferramentas, JSON / saída estruturada, visão, raciocínio e seus níveis, cache), o preço inicial público em USD com sua unidade, para mídia cada parâmetro de requisição com seus valores permitidos, uma requisição pronta (curl e JSON) e um link para a documentação. Um evento news é uma publicação de novidades.
• O guid de um evento nunca muda. O feed não contém resultados de geração registrados, apenas uma solicitação de exemplo.
• Consulte no máximo a cada poucos minutos: cada página tem seus próprios ETag e Last-Modified; envie If-None-Match / If-Modified-Since e uma página sem alterações responde 304 sem corpo. Para buscar apenas as novidades, guarde a data do último evento que você processou e faça uma requisição a ?since= com essa data.

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