429 es una respuesta real: indica contrapresión y siempre incluye
Retry-After. Consulta la tabla de códigos de error para QUEUE_BACKPRESSURE, PLAN_CONCURRENCY_LIMIT y
API_KEY_DAILY_LIMIT.
Regiones
Define la región conpayload.country (ISO 3166-1 alfa-2). El valor por defecto es US.
taskType × country que no se puede servir: CHATGPT, PERPLEXITY y GEMINI hacia
CN. Se rechaza al enviar con 422 REGION_UNSUPPORTED en lugar de encolarse para fallar después. Todos los
demás países que listamos los sirven todos los motores, y GOOGLE/AIMODE no usan nuestros pools de salida.
Buenas prácticas
1
Usa el envío en lote
Un
POST /v1/async/task/batch con 500 elementos cuesta un viaje de ida y vuelta. Quinientos envíos individuales cuestan quinientos.2
Ordena el trabajo dependiente
El orden de ejecución no está garantizado. Espera a que una tarea termine antes de enviar trabajo que dependa de su resultado.
3
Vigila tu cola
GET /stats muestra la profundidad de la cola y los estados de las tareas. Úsalo para dosificar envíos grandes.