Documentation
Async tasks
GET /api/v1/tasks/{task_id} — check the status of a long-running job.
GET
/api/v1/tasks/{task_id}Bearer sk-app-…Orux AI uses a unified async task model for video, music, and queue-based image jobs (Midjourney imagine/upscale/variation, Suno extend, etc.). Submit returns task_id, GET reports current status, terminal states fire webhooks.
Status values#
| Field | Type | Default | Description |
|---|---|---|---|
queued | string | — | Accepted, waiting for a worker. |
running | string | — | Worker is processing. |
success | string | — | Done. result is populated. |
failed | string | — | Upstream or routing failed. error is populated. |
expired | string | — | Job exceeded its TTL (24h default). |
Response#
| Field | Type | Default | Description |
|---|---|---|---|
task_id | string | — | Echo of the submitted id. |
status | string | — | One of the values above (uppercase on the wire: QUEUED / RUNNING / SUCCESS / FAILED / EXPIRED). |
alias | string | — | The short model id you submitted with. |
upstream_model | string | — | The actual upstream model the gateway resolved your alias to. |
channel | string | — | Internal routing identifier for the backend that served the job. Informational only — safe to ignore. |
submit_time | string | — | ISO-8601 timestamp the job was accepted. |
finish_time | string | — | ISO-8601 timestamp the job finished. Absent while still running. |
duration_sec | int | — | Wall-clock seconds spent on the upstream. Absent until finished. |
result_urls | array | — | On success: URLs of the generated assets (video / audio / image / etc). |
error_code | string | — | Populated on FAILED — stable machine code. |
error_message | string | — | Populated on FAILED — human-readable description. |
Examples#
Poll a task
curl https://orux.top/api/v1/tasks/task_01HZX... \
-H "Authorization: Bearer $ORUX_API_KEY"