t2v / i2v / r2v / video-edit 任一种），使用此端点轮询状态并获取结果。
端点
GET /v1/video/generations/{task_id}
快速示例
curl https://www.anyfast.ai/v1/video/generations/asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya \
-H 'Authorization: Bearer YOUR_API_KEY'
import requests, time
task_id = "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya"
while True:
r = requests.get(
f"https://www.anyfast.ai/v1/video/generations/{task_id}",
headers={"Authorization": "Bearer YOUR_API_KEY"}
).json()
status = r["data"]["status"]
if status == "SUCCESS":
print("视频 URL:", r["data"]["result_url"])
break
if status == "FAILURE":
print("失败:", r["data"]["fail_reason"])
break
time.sleep(15)
任务状态
data.status | 含义 | 后续动作 |
|---|---|---|
NOT_START | 任务已接收，尚未开始 | 继续轮询 |
QUEUED | 排队中 | 继续轮询 |
IN_PROGRESS | 处理中（progress 从 50% 开始递进） | 继续轮询，建议 15s 间隔 |
SUCCESS | 完成 | 读取 data.result_url |
FAILURE | 失败 | 读取 data.fail_reason，平台自动退费 |
result_url 有效期 24 小时——请立即下载或转存。
顶层响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
data.task_id | string | 平台任务 ID（asyntask_xxx 格式） |
data.action | string | 任务子类型：generate / firstTailGenerate / referenceGenerate / omniGenerate |
data.status | string | 任务状态（见上表） |
data.result_url | string | 预签名下载 URL，有效期 24 小时。失败任务此字段省略 |
data.fail_reason | string | 成功时复制 result_url（兼容老客户端）；失败时为错误信息 |
data.submit_time | int64 | 提交时间戳（Unix 秒） |
data.start_time | int64 | 上游开始时间戳；未开始为 0 |
data.finish_time | int64 | 完成时间戳 |
data.progress | string | 进度百分比文本，如 "50%"、"100%" |
data.request_id | string | 请求溯源 ID |
data.data | object | 上游 DashScope 原始 output + usage（见下文） |
data.data — 上游 DashScope 输出
| 字段 | 说明 |
|---|---|
output.task_id | 上游 DashScope 任务 ID（与外层 task_id 不同） |
output.task_status | 上游状态：PENDING / RUNNING / SUCCEEDED / FAILED / CANCELED / UNKNOWN |
output.video_url | 上游交付的视频 URL（与外层 result_url 一致） |
output.orig_prompt | 原始 prompt 回显 |
output.submit_time / scheduled_time / end_time | 上游各阶段时间（字符串日期格式） |
usage.SR | 实际生成的分辨率档位（数字 720 / 1080） |
usage.duration | 计费总时长 |
usage.input_video_duration | 输入视频时长（t2v / i2v / r2v 是 0；video-edit 才有） |
usage.output_video_duration | 实际生成视频时长 |
usage.ratio | 实际宽高比（仅 t2v / r2v 返回；i2v / video-edit 不返回） |
usage.video_count | 视频数量（恒为 1） |
成功响应
{
"code": "success",
"message": "",
"data": {
"task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
"action": "generate",
"status": "SUCCESS",
"fail_reason": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
"submit_time": 1777343862,
"start_time": 1777343866,
"finish_time": 1777343961,
"progress": "100%",
"request_id": "20260428023742441081000FMrSbjcs",
"data": {
"output": {
"task_id": "e45a6a1b-6f05-43e5-ab06-ddfdc97587a7",
"task_status": "SUCCEEDED",
"submit_time": "2026-04-28 10:37:42.625",
"scheduled_time": "2026-04-28 10:37:42.652",
"end_time": "2026-04-28 10:39:04.185",
"orig_prompt": "一只猫在草地上奔跑",
"video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=..."
},
"request_id": "53121cad-c008-9b96-af1d-4289a4fc714b",
"usage": {
"SR": 720,
"duration": 5,
"input_video_duration": 0,
"output_video_duration": 5,
"ratio": "16:9",
"video_count": 1
}
}
}
}
失败响应
{
"code": "success",
"message": "",
"data": {
"task_id": "asyntask_xxx",
"action": "generate",
"status": "FAILURE",
"fail_reason": "task failed, code: InvalidParameter, message: Field required: input.prompt",
"submit_time": 1777291928,
"start_time": 0,
"finish_time": 1777291932,
"progress": "100%",
"request_id": "20260427121207756348000PWNdDIZK"
}
}
API 参考
HappyHorse 任务查询 交互式 Playground。