Tasks API
Preview async task lifecycle endpoints.
Status: Preview — task lookup and best-effort cancel are callable.
Operations
| Endpoint | Description |
|---|---|
GET /v1/tasks | List recent tasks for the current API key's tenant. |
GET /v1/tasks/{task_id} | Fetch one task, including final output when available. |
POST /v1/tasks/{task_id}/cancel | Request cancellation. Terminal tasks are returned unchanged. |
Statuses
Tasks move through queued, running, then one terminal state: succeeded, failed, or canceled.
For Preview music generation, poll task detail until terminal. The final output contains clips[] with audio URLs and artifact ids.