Modelos e preços

Os preços dos modelos são publicados em dólares. Um modelo pode estar disponível por mais de um provedor upstream, e cada provedor pode publicar um preço de cliente diferente. Este guia explica de onde vêm esses preços e como calcular uma requisição antes de enviá-la.

Encontre um ID de modelo

Use o ID de modelo retornado pela API. Não monte um ID a partir do nome de exibição ou do slug da página.

GET /api/v1/models também aceita exclude_video_and_decisions=true e um filtro opcional provider. A descoberta lê o catálogo e não cobra por uma chamada de modelo.

Modelos de imagem não têm endpoint de lista dedicado. Filtre GET /api/v1/models por model_kind: "image_generation"; consulte Geração de imagens.

Para uma visão navegável, abra o catálogo de modelos ou a página de preços. As páginas de detalhe do modelo mostram limites de contexto, protocolos e todos os preços publicados dos fornecedores.

Provedores e canais

Cada modelo tem uma lista de canais públicos. Um canal é uma configuração de provedor upstream para aquele modelo, como Anthropic, Azure, Google ou um canal Claude com desconto.

• is_default marca o canal usado para o preço em destaque e para a rota padrão.
• runnable marca se o canal está disponível para requisições no momento.
• standard_pricing contém as tarifas padrão do provedor.
• discount_multiplier é o multiplicador de venda, de 0 a 1.
• pricing_mode é configured_rates ou upstream_cost.

A página do modelo ordena os fornecedores com o padrão primeiro e depois pelo preço de entrada do cliente, do menor para o maior. Para escolher um fornecedor explicitamente, consulte Canais e roteamento de provedores.

Como o preço de cliente é calculado

Para um canal configured_rates:

customer price = standard rate × discount multiplier

Por exemplo, um canal com tarifa padrão de entrada de $1.00 por 1M de tokens e multiplicador 0.8 cobra $0.80 por 1M de tokens.

Para um canal upstream_cost, standard_pricing é null, não zero. A cobrança se baseia no custo de geração informado multiplicado pelo desconto congelado. A página do modelo mostra a regra real daquele canal.

As tarifas por token são exibidas por 1 milhão de tokens para facilitar a leitura. A cobrança usa a precisão por token do snapshot de preço atual.

Unidades de cobrança

Se várias condições de preço corresponderem, vale a primeira condição correspondente listada nos detalhes de preço do modelo. Consulte a página de detalhe do modelo para ver as faixas antes de estimar um trabalho grande.

Tarifas de cache

Quando um modelo publica input_cache_read ou input_cache_write, essas tarifas aparecem no catálogo e na página do modelo. O uso de cache é informado pela resposta do protocolo; um acerto de cache não é garantido e depende do provedor upstream e da requisição. A Felo não adiciona um interruptor de cache separado.

Onde conferir os preços

• Página de preços — compare modelos e fornecedores.
• Página de detalhe do modelo — tabela completa de tarifas, faixas e condições.
• API do catálogo de modelos — os mesmos dados em JSON, atualizados em até 60 segundos.

Não codifique preços diretamente na sua aplicação. Leia o catálogo ou mostre um link para a página de preços, assim uma mudança de preço não quebra silenciosamente sua estimativa de custo.

Estime uma requisição

1. Encontre o ID do modelo e o canal que pretende usar.
2. Leia as tarifas de entrada, de saída e de cache daquele canal.
3. Multiplique pelas suas contagens de tokens esperadas, ou use a tarifa por requisição ou por duração para modelos que não usam tokens.
4. Some qualquer faixa condicional que se aplique.
5. Deixe uma margem para novas tentativas e variação de saída.

Relacionados

• Canais e roteamento de provedores
• Geração de imagens
• Protocolos e SDKs
• Cobrança e créditos