Skip to content

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 modelosUnidade típicaNotas
gemini-2.5-flash-imagepor imagemGeração e edição rápida de imagens.
gemini-3.1-flash-lite-imagepor imagemGeração de imagens Gemini 3.1 Flash Lite Image mais rápida e econômica.
gemini-3.1-flash-image-previewpor imagemGeração de imagens Gemini equilibrada com controle de proporção.
gemini-3-pro-image-previewpor imagemGeração e edição de imagens Gemini premium.
gpt-image-1.5por imagemGeração de imagens de maior qualidade pode custar mais em tamanhos maiores.
veo3.1-lite / veo3.1-fast / veo3.1-qualityper second × resolutionCost depends on model, seconds, and resolution.
seedance-2 / seedance-2-fast / seedance-2-miniper second × resolutionCost depends on model, seconds, and resolution.
kling-3.0-turbo / kling-v3 / kling-v3-omniper second × resolutionCost depends on model, seconds, and resolution.
wan2.6 / wan2.6-flashper second × resolutionCost depends on model, seconds, and resolution.
grok-video-3 / grok-video-1.5-previewper second × resolutionCost depends on model, seconds, and resolution.
happyhorse-1.1per second × resolutionCost depends on seconds and resolution.

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 reembolsados

Se uma tarefa de geração falhar depois que créditos foram consumidos ou reservados, o Pixapi devolve os créditos afetados à conta e marca a linha do livro como Reembolsado. Consulte Falhas na geração de imagens para causas comuns e orientação de nova tentativa.

Créditos insuficientes

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

json
{
  "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.