Omni APIOmni API

Tasks

Task lifecycle, queue position, cancellation, and compensation.

Tasks

Tasks are the common unit for image, video, and future model groups.

Lifecycle

StatusMeaning
queuedThe task was accepted and is waiting for a worker.
runningA worker has started processing the task.
succeededOutputs are ready.
failedThe task failed. User-facing pages hide detailed internal errors.
canceledThe task was canceled and eligible credits can be returned automatically.
failed_compensatedAdmin or user-requested compensation was recorded for a failed task.

Queue position

Low-priority tasks can wait behind higher-priority work. The task detail response should expose queue position instead of rejecting submissions when capacity is temporarily tight.

Priority

Website tasks follow the original Omni image/video priority model:

  • Eco mode submits priority 0.
  • Fast credits submit priority 1.
  • Extra upgrade credits can promote a task to priority 2.

API tasks use fast credits only for the current launch stage.

Cancellation and compensation

Canceled tasks can return eligible credits automatically. Failed tasks are not automatically refunded; the task detail page can expose a compensation action, and admin settlement keeps the audit trail.