Api
视频任务
查询 Vidrush 视频任务状态并获取生成的视频 URL。
查询任务
GET https://vidrush-ai.com/api/v1/tasks/{taskId}
Authorization: Bearer sk-your-api-key将 {taskId} 替换为 POST /api/v1/videos 返回的 data.id。
curl -H "Authorization: Bearer $VIDRUSH_API_KEY" \
https://vidrush-ai.com/api/v1/tasks/task_123响应使用 { code, message, data } 信封。data 是公开任务记录；该端点始终将 data.taskUrls 返回为数组。
轮询
按 5 秒间隔轮询。data.status 进入终态后停止。
| 状态 | 含义 | 操作 |
|---|---|---|
pending | 任务已被接受 | 继续轮询 |
processing | 提供方正在生成 | 继续轮询 |
success | 生成完成 | 使用 data.taskUrls 中的 URL |
failed | 生成失败 | 停止并报告失败 |
canceled | 生成已取消 | 停止并报告取消 |
任务列表
GET /api/v1/tasks 返回你自己的任务，按创建时间倒序，结构与单任务端点相同（已脱敏）。
| 查询参数 | 类型 | 说明 |
|---|---|---|
status | string | pending、processing、success、failed 或 canceled |
media_type | string | video、image、music、audio 或 speech |
page | integer | 从 1 开始的页码，默认 1 |
limit | integer | 1–100，默认 20；data.has_more 表示是否还有下一页 |
{
"code": 0,
"message": "ok",
"data": {
"tasks": [{ "id": "task_123", "status": "success", "mediaType": "video" }],
"page": 1,
"limit": 20,
"has_more": false
}
}访问控制和错误
API key 只能读取其所属用户的任务。任务不存在或属于其他用户时，接口返回 HTTP 404、code: -1 和 message: "task not found"。
v1 没有取消任务的端点。将任务处理返回的 canceled 视为终态。