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.
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \ -H "X-API-Key: $OMNIDOC_API_KEY"Các trạng thái vòng đời
Phần tiêu đề “Các trạng thái vòng đời”status | Ý nghĩa |
|---|---|
pending | Đã tạo, đang chờ trong hàng đợi |
processing | Đang được xử lý |
completed | Hoàn tất; có thể xem kết quả |
failed | Thấ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.
Các giai đoạn tiến triển
Phần tiêu đề “Các giai đoạn tiến triển”stage | Ý nghĩa |
|---|---|
queued | Trong hàng đợi |
accepted / preflight | Đã chấp nhận và đang chuẩn bị |
translating | Dịch thuật |
writing_artifacts / finalizing | Tạo và đăng ký kết quả |
completed / failed | Kế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.
Liệt kê và hủy
Phần tiêu đề “Liệt kê và hủy”GET /api/v1/jobs?limit=20&before=2026-10-01T12:00:00ZPOST /api/v1/jobs/{job_id}/cancelViệ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.
Lấy kết quả
Phần tiêu đề “Lấy kết quả”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.