Voltar para o blog
Engenharia
Publicado em 28 de jun. de 2026
7 min de leitura
APIs de geração de imagens em lote: filas, idempotência, orçamentos e falhas parciais
Projete jobs de geração de imagens em lote que possam pausar, reproduzir, impor limites e lidar com sucesso parcial.
Conclusão principalUm lote não são dez mil imagens. São dez mil jobs rastreáveis e recuperáveis de forma independente.
Por que isso merece sua própria decisão
A geração em lote expõe simultaneamente limites, capacidade do provedor, envios duplicados, gasto descontrolado e falhas parciais. Com apenas estado em nível de lote, um filho com falha pode forçar uma reexecução completa, gerando custos duplicados e resultados ambíguos.
Framework de decisão
- Dê a cada entrada um job_id estável e uma chave de idempotência.
- Defina concorrência, taxa, orçamentos por job e totais do lote.
- Reproduza apenas os filhos com falha ou rejeitados.
Colocando isso em um fluxo de trabalho do ModelRush
Uma fila expande o lote em jobs filhos do ModelRush. O estado registra entrada, template, modelo, tentativas, custo e resultado. O agendador controla a concorrência usando a saúde do provedor e o orçamento. A conclusão do lote permite sucesso parcial e emite uma lista de reparo.
O que medir após o lançamento
- Distribuição de sucesso, retry, rejeição e falha terminal.
- Faturamento duplicado e contagem de resultados duplicados.
- Tempo de conclusão do lote e taxa de pico de gasto.
Um lote não são dez mil imagens. São dez mil jobs rastreáveis e recuperáveis de forma independente.
