Lotes e retry seguro

Um pedido, uma identidade

Idempotency-Key é um UUID que você salva antes do envio. Ele identifica a intenção de criação. Mesma chave e mesmo payload recuperam o pedido salvo; mesma chave com payload diferente resulta em 409 IDEMPOTENCY_CONFLICT.

Use outra chave somente para uma criação nova e intencional. Não gere um UUID dentro de um bloco de retry: isso transformaria cada tentativa em uma nova intenção.

Depois de um timeout:

1. Se recebeu o ID, consulte esse ID.
2. Se perdeu a resposta, envie exatamente o mesmo payload e a mesma chave.
3. Se a resposta indicar cota/fila/rate limit, respeite código e Retry-After.
4. Se o estado for attention_required, acompanhe o pedido original e procure suporte se necessário.

Falha de rede, 5xx, arquivo ainda ausente ou demora não comprovam que a geração não foi enviada. O Infinity Flow preserva registros mínimos de replay mesmo depois de expirar o histórico visível.

Enviar lote

curl --fail-with-body 'https://infinityflow.stream/api/v1/batches' \
  -H "Authorization: Bearer $INFINITY_FLOW_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: f22cd158-5cb4-456b-a0b5-a25c4311a9a2' \
  --data '{"items":[{"prompt":"Uma floresta ao amanhecer","mediaKind":"video","aspect":"16:9"},{"prompt":"Uma floresta ao anoitecer","mediaKind":"video","aspect":"16:9"}]}'

Substitua a chave ilustrativa por um UUID novo salvo no seu sistema. A admissão do lote é atômica: todos os itens precisam caber no limite de lote, fila e saldo antes de aceitar. O servidor retorna batch.id e os filhos. Cada filho é uma geração independente depois de aceito.

Use GET /batches/{id} para consultar. Se um filho falhar, não reenvie o lote inteiro com outra chave. A recuperação não deve repetir os filhos bem-sucedidos ou incertos.

Lote não é paralelismo

O número de itens enviados não indica quantos processam ao mesmo tempo. Capacidade, leases, prioridade e disponibilidade operacional controlam execução. Trabalho aceito fica elegível imediatamente; falta de saldo diário rejeita uma nova admissão, sem agendá-la para o dia seguinte.