Ids de modelo e variantes

Os ids de modelo na api14 usam o formato provider/model, por exemplo openai/gpt-5-mini. Passe o id no campo model de qualquer requisição.

{ "model": "anthropic/claude-sonnet-4.5" }

Como encontrar ids de modelo

• Navegue pela página de modelos: cada modelo com seu id, preços, tamanho de contexto e recursos.
• Chame GET /models pelo código; filtre por categoria com ?category=image. Veja Modelos.

Alguns exemplos:

Os ids diferenciam maiúsculas de minúsculas. Um id desconhecido ou desativado retorna 404 model_not_found.

Variantes

Uma variante é um sufixo após dois-pontos que muda a forma como a requisição é atendida. As variantes funcionam com o mesmo modelo base; valem as regras de disponibilidade e de lista permitida do modelo base.

{ "model": "openai/gpt-5-mini:online" }

:nitro e :floor são atalhos para a ordenação de provedores, equivalentes a provider: { sort: "throughput" } e provider: { sort: "price" }. Veja Roteamento de provedores e fallbacks.

Fallbacks de modelos

Envie um array models para tentar outros modelos quando o primeiro falhar ou estiver indisponível:

{
  "model": "anthropic/claude-sonnet-4.5",
  "models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
  "messages": [{ "role": "user", "content": "Hello" }]
}

Todos os modelos da lista precisam estar disponíveis e permitidos para a sua chave e o seu plano; caso contrário, a requisição é rejeitada antes de ser enviada. O campo model da resposta informa qual deles respondeu, e você paga o preço desse modelo.

Listas permitidas e planos

• Uma chave com lista de modelos permitidos só pode usar os ids listados; os demais retornam 403 model_not_allowed.
• Todos os planos, inclusive o Free, cobrem todas as categorias de modelo, incluindo vídeo e música/áudio. Um plano limitado a certas categorias retorna 403 plan_required para as demais. Veja Preços e cobrança.

Mudanças nos modelos

O catálogo é atualizado automaticamente. Os novos modelos aparecem por conta própria; os modelos removidos retornam 404 model_not_found. Fixe ids exatos em produção e use fallbacks com models para ter resiliência.