Bỏ qua để đến nội dung

Trạng thái công việc

GET /api/v1/jobs/{job_id}

Một truy vấn chỉ đọc trạng thái và không tốn tín dụng.

Terminal window
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \
-H "X-API-Key: $OMNIDOC_API_KEY"
statusÝ nghĩa
pendingĐã tạo, đang chờ trong hàng đợi
processingĐang được xử lý
completedHoàn tất; có thể xem kết quả
failedThất bại hoặc bị hủy; xem error_msg

status cho bạn biết liệu công việc đã kết thúc hay chưa.

stageÝ nghĩa
queuedTrong hàng đợi
accepted / preflightĐã chấp nhận và đang chuẩn bị
translatingDịch thuật
writing_artifacts / finalizingTạo và đăng ký kết quả
completed / failedKết thúc

stage_progress là tiến trình hiển thị từ 0 đến 100; nó không được sử dụng để lập hóa đơn. Khi đang trong hàng đợi, queue_position có thể cho biết số lượng công việc đứng trước, hoặc có thể là null.

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

Việc hủy là nỗ lực tốt nhất; một công việc đã kết thúc sẽ trả về 409. Các công việc bị hủy không bị tính phí, điều này bạn có thể xác nhận trong hồ sơ tín dụng.

Sau khi công việc hoàn tất:

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

Danh sách kết quả trống trong khi tác vụ vẫn đang chạy.