Estado del trabajo
GET /api/v1/jobs/{job_id}Una consulta solo lee el estado y no consume créditos.
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \ -H "X-API-Key: $OMNIDOC_API_KEY"Estados del ciclo de vida
Sección titulada «Estados del ciclo de vida»status | Significado |
|---|---|
pending | Creado, esperando en la cola |
processing | En proceso |
completed | Finalizado; los resultados pueden leerse |
failed | Fallido o cancelado; consulte error_msg |
status indica si el trabajo ha finalizado.
Etapas del progreso
Sección titulada «Etapas del progreso»stage | Significado |
|---|---|
queued | En la cola |
accepted / preflight | Aceptado y preparándose |
translating | Traducción |
writing_artifacts / finalizing | Generación y registro de los resultados |
completed / failed | Finalizado |
stage_progress es un progreso de visualización desde 0 hasta 100; no se utiliza para la facturación. Mientras está en cola, queue_position puede indicar el número de trabajos que le preceden o puede ser null.
Listar y cancelar
Sección titulada «Listar y cancelar»GET /api/v1/jobs?limit=20&before=2026-10-01T12:00:00ZPOST /api/v1/jobs/{job_id}/cancelLa cancelación se realiza con el mejor esfuerzo; un trabajo que ya ha finalizado devuelve 409. Los trabajos cancelados no se facturan, lo cual puede confirmarse en el registro de créditos.
Obtener los resultados
Sección titulada «Obtener los resultados»Una vez completada la tarea:
GET /api/v1/artifacts?job_id={job_id}La lista de resultados está vacía mientras el trabajo aún se está ejecutando.