Cobrança e créditos

A Pixapi mede o uso de modelos com créditos. Uma requisição pode consumir créditos com base no modelo selecionado, contagem de saídas, resolução, duração, qualidade e custo do provedor.

Ciclo de vida dos créditos

1. Seu aplicativo envia uma requisição com um ID de modelo e parâmetros.
2. A Pixapi estima se a conta tem créditos suficientes.
3. O provedor do modelo é chamado.
4. Os créditos são consumidos após uma saída bem-sucedida, ou de acordo com a política de tarefa específica do modelo.

Exemplos de custo

Família de modelos	Unidade típica	Notas
gemini-2.5-flash-image	por imagem	Geração e edição rápida de imagens.
gemini-3.1-flash-image-preview	por imagem	Geração de imagens Gemini equilibrada com controle de proporção.
gemini-3-pro-image-preview	por imagem	Geração e edição de imagens Gemini premium.
gpt-image-1.5	por imagem	Geração de imagens de maior qualidade pode custar mais em tamanhos maiores.
veo	por segundo	O custo do vídeo depende da duração e qualidade.

Use a página de preços ao vivo para limites atuais do plano e pacotes de créditos. Revise o saldo da conta em Créditos e detalhes da assinatura em Cobrança.

Créditos insuficientes

Se a conta não tiver créditos suficientes, a Pixapi retorna:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this request."
  }
}

Seu aplicativo deve mostrar Créditos, Cobrança ou uma ação de upgrade em vez de tentar novamente automaticamente.