Cola y límites

ColaCopy Anchor Link

• Se procesan hasta 10 trabajos por cuenta al mismo tiempo.
• Detrás de ellos esperan hasta 30 trabajos en la cola. Mientras un trabajo espera, GET /edits/{id} devuelve su queue_position (trabajos que esperan delante; los que están en curso no cuentan, así que 0 significa que es el siguiente en empezar) y estimated_seconds (nuestra estimación de cuándo terminará).
• Cuando ya hay 30 trabajos esperando, POST /edits devuelve 503 queue_full con una cabecera Retry-After. No se te cobra.
• Un trabajo puede durar hasta 10 minutos después de salir de la cola. El tiempo de espera no cuenta, así que con la cola llena el último trabajo puede tardar unos 30 minutos en el peor caso. La mayoría de los trabajos terminan en 1–2 minutos, 9 de cada 10 en 3 minutos.

Límites de frecuenciaCopy Anchor Link

Cada cuenta, compartida por todas sus claves, puede hacer en cualquier ventana móvil de 60 segundos:

Cuenta toda solicitud con una clave válida, incluidas las que se rechazan con un error. Las solicitudes sin clave o con una clave no válida no cuentan para ninguna cuenta.

Al superarlo se devuelve 429 rate_limited con Retry-After, siempre un número entero de segundos: el tiempo hasta que caduca la solicitud más antigua de la ventana. GET /account devuelve tus límites actuales en limits. Las cuentas Empresa pueden tener límites más altos.

SondeoCopy Anchor Link

• Mientras un trabajo esté en processing, o en queued con queue_position 0, consulta GET /edits/{id} cada 5 segundos.
• Mientras esté en queued más atrás, consulta cada 30 segundos. estimated_seconds indica cuándo debería terminar el trabajo, no cuándo consultar.

Con 10 trabajos en curso y 30 en cola eso son como máximo 190 lecturas por minuto, dentro del límite de 240. Para no sondear en absoluto, pasa callback_url y recibe un webhook.

ImágenesCopy Anchor Link

• JPEG, PNG o WebP, hasta 20 MB, lado mayor de hasta 8000 px.
• Envíala como image_url, image_base64, un archivo image multipart o un image_id de una llamada de OCR anterior; exactamente uno de ellos por solicitud.
• Hasta 20 sustituciones por edición.

Consulta Imágenes para saber cómo codificar cada método de subida, EXIF, transparencia y los archivos de resultado.

Reintentos segurosCopy Anchor Link

Envía una cabecera Idempotency-Key con cada POST /edits para poder reintentar con seguridad tras un tiempo de espera agotado o un error de red. Repetir la misma clave en 24 horas devuelve 202 con el id del trabajo original y su estado actual (puede que ya esté en processing o terminado) en lugar de crear —y cobrar— uno nuevo, aunque el cuerpo sea distinto. Las claves son por cuenta y las comparten todas sus claves de API. Una solicitud rechazada (cualquier 4xx o 5xx) no consume su clave, así que puedes reenviarla con la misma clave después de corregirla.