429 é uma resposta real: indica contrapressão e sempre traz
Retry-After. Veja a tabela de códigos de erro para QUEUE_BACKPRESSURE, PLAN_CONCURRENCY_LIMIT e API_KEY_DAILY_LIMIT.
Regiões
Defina a região compayload.country (ISO 3166-1 alfa-2). O padrão é US.
taskType × country que não pode ser atendida: CHATGPT, PERPLEXITY e GEMINI para
CN. Ela é rejeitada no envio com 422 REGION_UNSUPPORTED em vez de entrar na fila para falhar depois. Todos os
outros países listados são atendidos por todos os mecanismos, e GOOGLE/AIMODE nem usam nossos pools de saída.
Boas práticas
1
Use o envio em lote
Um
POST /v1/async/task/batch com 500 itens custa uma ida e volta. Quinhentos envios individuais custam quinhentas.2
Ordene o trabalho dependente
A ordem de execução não é garantida. Espere uma tarefa terminar antes de enviar trabalho que dependa do resultado dela.
3
Monitore sua fila
GET /stats mostra a profundidade da fila e o estado das tarefas. Use-o para dosar envios grandes.