Path Parameters
string
required
The task ID returned from the create video request. Treat
id and task_id as the same async identity.If a create response returns
poll_url, call that exact URL. When it points to /v1/tasks/{id}, treat that as the canonical fixed status endpoint.If the task no longer exists or is no longer available in the public task record, AI Sonar returns async_task_not_found with the message Task not found or no longer available.Response
string
Canonical async task identifier.
string
Async task identifier alias.
string
Preferred polling URL when the create response supplies one.
string
AI Sonar billing transaction ID when settlement already completed. This is the dashboard/accounting transaction identifier and is separate from the async
id / task_id.string
Task status:
pending, processing, completed, failed.number
Optional progress value. Returned only when a real progress value is available; use
status to determine completion.string
URL of the generated video (when completed).
object
Single video payload with
url, duration, width, and height when available.array
Multiple video payloads when the generation task returns more than one output.
string
Error message (if failed).
integer
Creation timestamp.
integer
Last update timestamp.
string
Model used for the task.
Polling Best Practices
- Poll every 5-10 seconds
- Implement exponential backoff for long tasks
- Set a maximum timeout (e.g., 10 minutes)
- Handle
failedstatus gracefully