Api

Video Tasks

Query Vidrush video task status and retrieve generated video URLs.

Get a task

GET https://vidrush-ai.com/api/v1/tasks/{taskId}
Authorization: Bearer sk-your-api-key

Replace {taskId} with the data.id returned by POST /api/v1/videos.

curl -H "Authorization: Bearer $VIDRUSH_API_KEY" \
  https://vidrush-ai.com/api/v1/tasks/task_123

The response uses { code, message, data }. data is the public task record, and data.taskUrls is always returned as an array by this endpoint.

Polling

Poll at a 5-second interval. Stop when data.status becomes a terminal state.

StatusMeaningAction
pendingThe task has been acceptedKeep polling
processingThe provider is generating outputKeep polling
successGeneration completedUse the URLs in data.taskUrls
failedGeneration failedStop and report the failure
canceledGeneration was canceledStop and report the cancellation

Access control and errors

The API key may read only tasks owned by its user. A nonexistent task or a task owned by another user returns HTTP 404 with code: -1 and message: "task not found".

There is no v1 task-cancel endpoint. Treat canceled as a terminal status returned by task processing.