Referência da API
Cobrança e saldo
Liquidação por chamada, paga pela carteira. Modelos com preço por token são cobrados por 1M de tokens de entrada e de saída; modelos de imagem / vídeo / tarefa são cobrados por requisição. Requisições com falha são reembolsadas automaticamente.
#Preço por token
Os tokens de entrada e de saída são medidos separadamente. O preço completo de cada modelo aparece na ficha em /models; cada requisição concluída mostra o consumo real final no log de requisições.
{
"usage": {
"prompt_tokens": 128,
"completion_tokens": 402,
"total_tokens": 530
}
}A cota é pré-reservada no início da requisição (estimativa do pior caso a partir de max_tokens) e depois conciliada com o uso informado pelo provedor quando a resposta termina — você só paga pelo uso real.
#Preço por requisição
Modelos de imagem, vídeo, TTS e outros modelos baseados em tarefas cobram um preço fixo por chamada bem-sucedida. Resoluções ou durações diferentes podem ter preços diferentes — sempre confira a ficha do modelo antes.
#Faixas de preço
Modelos cobrados por requisição podem ter várias faixas em um mesmo modelo: as faixas de imagem dependem de tamanho e qualidade; as de vídeo, de duração e resolução. A faixa é definida pelos parâmetros da sua requisição no momento do envio, e o preço de cada faixa aparece na ficha do modelo.
Preço por faixa
#Reembolsos
A cota pré-cobrada é devolvida automaticamente quando uma requisição falha ou uma tarefa assíncrona nunca é resolvida. O log de requisições mostra o consumo real final, então chamadas com falha não aparecem como uma cobrança e um reembolso separados.
#Saldo e recarga
#A carteira
Todo o uso é liquidado a partir de uma única carteira pré-paga — não há faturamento pós-pago. Todas as chaves gastam do mesmo saldo, a menos que a chave tenha o próprio teto de cota.
#Recarga
Recarregue em Console → Carteira. As formas de pagamento disponíveis (cartão / outros provedores) e o valor mínimo de recarga aparecem no checkout; códigos de resgate também podem ser aplicados ali e são creditados na hora.
O saldo não expira. Se um pagamento for concluído, mas o saldo não mudar em alguns minutos, abra um chamado de suporte com a referência do pagamento.
Abrir Carteira#Saldo baixo
Quando o saldo não cobre a estimativa pré-reservada de uma requisição, a chamada falha na hora com 402 insufficient_quota — nada é cobrado. Recarregue e tente novamente; streams longos já em andamento nunca são cortados no meio da resposta.
#Uso e logs
#Painel de uso
Console → Uso mostra gráficos de tokens e gastos por modelo e por dia, separados por chave — a forma mais rápida de ver qual projeto ou modelo está puxando o custo.
Abrir Uso#Consumo real
Console → Log de requisições é a fonte da verdade dos gastos com a API para o cliente. Cada linha traz o horário, o modelo, o uso de tokens ou o preço da chamada, o ID da requisição e o valor final efetivamente consumido.
Abrir Uso#IDs de requisição
Cada linha do log de requisições traz o identificador da requisição e o horário. Ao abrir um chamado de suporte sobre uma chamada específica, cite essa linha (horário, modelo, ID da requisição) — isso permite ao suporte rastrear a tentativa exata no upstream.
Os prompts não são armazenados
Ainda com problemas?
Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.