Aller au contenu

État du travail

GET /api/v1/jobs/{job_id}

Une requête ne fait que lire l’état et n’occasionne aucun crédit.

Fenêtre de terminal
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \
-H "X-API-Key: $OMNIDOC_API_KEY"
statusSignification
pendingCréé, en attente dans la file d’attente
processingEn cours de traitement
completedTerminé ; les résultats peuvent être consultés.
failedÉchec ou annulation ; voir error_msg

status indique si le travail s’est terminé.

stageSignification
queuedDans la file d’attente
accepted / preflightAccepté et en préparation
translatingTraduction
writing_artifacts / finalizingGénération et enregistrement des résultats
completed / failedTerminé

stage_progress est une progression d’affichage allant de 0 à 100 ; il n’est pas utilisé pour la facturation. Lorsqu’il est en file d’attente, queue_position peut indiquer le nombre de travaux précédents, ou bien être null.

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

L’annulation est effectuée au meilleur effort ; un job déjà terminé renvoie 409. Les jobs annulés ne sont pas facturés, ce que vous pouvez vérifier dans l’historique des crédits.

Une fois le travail terminé :

GET /api/v1/artifacts?job_id={job_id}

La liste des résultats est vide alors que le travail est toujours en cours d’exécution.