Saltearse al contenido

Estado del trabajo

GET /api/v1/jobs/{job_id}

Una consulta solo lee el estado y no consume créditos.

Ventana de terminal
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \
-H "X-API-Key: $OMNIDOC_API_KEY"
statusSignificado
pendingCreado, esperando en la cola
processingEn proceso
completedFinalizado; los resultados pueden leerse
failedFallido o cancelado; consulte error_msg

status indica si el trabajo ha finalizado.

stageSignificado
queuedEn la cola
accepted / preflightAceptado y preparándose
translatingTraducción
writing_artifacts / finalizingGeneración y registro de los resultados
completed / failedFinalizado

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.

GET /api/v1/jobs?limit=20&before=2026-10-01T12:00:00Z
POST /api/v1/jobs/{job_id}/cancel

La 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.

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.