外观
查询视频任务
GET
https://vip.zen-ai.top/v1/videos/{video_id}查询 创建视频任务 返回的任务状态。建议每 5~10 秒查询一次,直到 status 为 completed 或 failed。
路径参数
video_idstring必填创建任务时返回的 id。
响应
idstring任务 ID。
objectstring固定为 video。
statusstring任务状态。
可选值
queuedin_progresscompletedfailedprogressinteger进度 0–100。
completed_atinteger完成时间戳(完成后返回)。
expires_atinteger结果过期时间戳,过期后可能无法下载。
errorobject失败时返回 {"code": "...", "message": "..."}。
请求示例
bash
curl https://vip.zen-ai.top/v1/videos/video_68d9b1c2e4f0a8b3 \
-H "Authorization: Bearer $VIP_API_KEY"python
import time
import requests
headers = {"Authorization": "Bearer sk-xxxxxxxx"}
video_id = "video_68d9b1c2e4f0a8b3"
while True:
info = requests.get(f"https://vip.zen-ai.top/v1/videos/{video_id}", headers=headers).json()
print(info["status"], info.get("progress"))
if info["status"] in ("completed", "failed"):
break
time.sleep(8)响应示例
json
{
"id": "video_68d9b1c2e4f0a8b3",
"object": "video",
"model": "sora-2",
"status": "in_progress",
"progress": 45,
"created_at": 1790684800,
"seconds": "4",
"size": "1280x720"
}json
{
"id": "video_68d9b1c2e4f0a8b3",
"object": "video",
"model": "sora-2",
"status": "completed",
"progress": 100,
"created_at": 1790684800,
"completed_at": 1790684912,
"expires_at": 1790771312,
"seconds": "4",
"size": "1280x720"
}json
{
"id": "video_68d9b1c2e4f0a8b3",
"object": "video",
"model": "sora-2",
"status": "failed",
"progress": 0,
"created_at": 1790684800,
"error": { "code": "moderation_blocked", "message": "提示词未通过内容审核" }
}