Gerações com falha não são cobradas

A Makernice não cobra por gerações de vídeo ou imagem com IA que falham. Ao criar uma geração, o preço cotado fica reservado no seu saldo pré-pago. A reserva vira cobrança quando a execução termina. Se a execução falhar ou o tempo esgotar, a reserva é liberada por completo. Rejeições da moderação da entrada antes da geração e cancelamentos na fila também liberam a reserva por completo. A única exceção: se um resultado concluído for bloqueado pela moderação por violar a política, a execução ainda é cobrada; você pode pedir revisão manual ao suporte.

Vale para todos os 17 modelos em uma única chave de API. Fonte: Política de Reembolso §2 · Documentação da API: preços e cobrança. Última verificação: 21 de outubro de 2026.

Preços em 4 de novembro de 2026 (versão v12 da tabela de preços).

Como funciona: cotação → reserva → cobrança ou liberação

1. Cotação. POST /v1/generations/quote retorna o valor exato para o seu modelo, modo, resolução e duração (vídeo é cobrado por segundo; imagem, por imagem). O preço fica travado por 12 minutos (expires_at). Cotar não custa nada e não reserva nada.
2. Reserva. POST /v1/generations com o quote_id coloca esse valor em reserva; só então algum saldo é reservado, e ele é acertado quando a geração chega a um estado final. A geração começa com status: "queued" e billing: "held". O dinheiro continua no seu saldo; ele só fica reservado.
3. Cobrança na conclusão. Quando a execução termina, o valor reservado é cobrado (billing: "charged"). O status fica moderating enquanto o resultado é verificado e passa a succeeded quando o arquivo está pronto para baixar.
4. Liberação em caso de falha. Se terminar como failed ou canceled, a reserva é liberada por completo (billing: "released"). Não há nada para solicitar: acontece automaticamente.

Uma reserva liberada não é um reembolso. O dinheiro nunca saiu do seu saldo, então não há pedido de reembolso, prazo de espera nem passagem pelo provedor de pagamento.

O que conta como geração com falha?

Segundo nossa Política de Reembolso (§2) e a documentação da API:

Qualidade não é condição de falha: um vídeo ou uma imagem entregue é cobrado, independentemente da sua opinião sobre ele. Por isso, cada página de modelo mostra primeiro o custo de um teste curto em baixa resolução.

Exemplos (versão v12 da tabela de preços, 4 de novembro de 2026)

Na API, os valores são strings em micro-USD (1,000,000 = $1.00).

{
  "id": "gen_…",
  "model": "seedance-2.5",
  "status": "failed",
  "amount": "2592000",
  "billing": "released",
  "outputs": [],
  "error": { "code": "timeout", "message": "…" }
}

Tratamento no código (Python)

import time, requests

def wait_for(gen_id, headers, api="https://api.makernice.com/v1"):
    while True:
        gen = requests.get(f"{api}/generations/{gen_id}", headers=headers, timeout=15).json()
        if gen["status"] == "succeeded":
            return gen                       # billing == "charged"
        if gen["status"] in ("failed", "canceled"):
            # billing == "released": the full hold is already back in your balance
            raise RuntimeError(f"{gen['status']}: {gen.get('error')}")
        time.sleep(5)                        # queued / generating / moderating / checking

Prefere webhooks? generation.failed e generation.canceled são enviados depois que o valor reservado é liberado; generation.succeeded, depois que ele é cobrado. Veja Webhooks.

Como evitar cobranças em dobro e limitar o gasto por chave de API?

• Sem cobrança em dobro em novas tentativas. POST /v1/generations exige um Idempotency-Key. Repetir a solicitação com a mesma chave, cotação e entrada retorna a geração original e não cobra de novo. (Idempotência)
• Limite de gasto por chave. Cada chave de API pode ter um limite de gasto e uma data de expiração. Uma solicitação que faria a chave passar do limite é rejeitada com 402 key_spend_limit_reached antes de qualquer reserva. Gerações com falha e canceladas não contam para o gasto da chave. (Autenticação)

O que verificar em qualquer API de vídeo com IA antes de integrar

Perguntas para fazer a qualquer API de vídeo com IA antes de construir sobre ela:

1. Uma execução com falha ou com tempo esgotado é cobrada, cobrada em parte ou não é cobrada?
2. O dinheiro é cobrado no envio ou quando a execução termina?
3. Uma rejeição da moderação de conteúdo custa algo, antes e depois da geração?
4. Dá para cancelar um trabalho na fila, e o dinheiro volta?
5. O preço é travado antes da execução ou calculado depois?
6. As novas tentativas são idempotentes, para que um erro de rede não cobre duas vezes?

Na Makernice, as respostas são: não é cobrada · quando a execução termina · não antes da geração (um resultado concluído bloqueado é cobrado) · sim, por completo · travado por uma cotação por 12 minutos · sim.

Perguntas frequentes

Relacionados

• Preços — preços unitários atualizados, recarga a partir de $15 (até $1,000), sem assinatura
• Como funciona o preço de APIs de vídeo com IA (em inglês) — preço = preço unitário × segundos; a cotação fica travada por 12 minutos
• Documentação da API: preços e cobrança · Consultar status · Cancelar · Idempotência
• Boas práticas para APIs de vídeo: idempotência, 429 e polling (em inglês)
• Política de Reembolso
• Todos os 17 modelos