获取视频生成任务状态

查询视频生成任务的状态和结果。

任务状态：

• queued: 排队中
• in_progress: 生成中
• completed: 已完成
• failed: 失败

查询任务

GET /v1/video/generations/{task_id}

认证方式：Bearer Token，格式为 Authorization: Bearer <API Key>。

路径参数：

参数名	类型	必填	说明
task_id	string	是	任务 ID

cURL

curl -X GET 'https://neolink.com/api/v1/video/generations/<task_id>' \
--header 'Authorization: Bearer <API Key>'

Python

import requests

API_KEY = "<API Key>"
TASK_ID = "<task Id>"

url = f"https://neolink.com/api/v1/video/generations/{TASK_ID}"

headers = {
    "Authorization": f"Bearer {API_KEY}"
}

response = requests.get(url, headers=headers)
response.raise_for_status()

print(response.json())

响应格式

成功响应（HTTP 200）

字段	类型	说明
task_id	string	任务 ID
status	string	任务状态（queued / in_progress / completed / failed）
url	string	视频地址 URL（成功时返回）
format	string	视频格式（如 mp4）
metadata	object	视频任务元数据
metadata.duration	integer	视频时长（秒）
metadata.fps	integer	帧率
metadata.width	integer	视频宽度
metadata.height	integer	视频高度
metadata.seed	integer	随机种子
error	object	错误信息对象
error.code	integer	错误代码
error.message	string	错误描述

{
  "task_id": "abcd1234efgh",
  "status": "completed",
  "url": "https://example.com/video.mp4",
  "format": "mp4",
  "metadata": {
    "duration": 5,
    "fps": 30,
    "width": 1280,
    "height": 720,
    "seed": 20231234
  },
  "error": {
    "code": 0,
    "message": "string"
  }
}

错误响应（HTTP 404）

字段	类型	说明
error	object	错误对象
error.message	string	错误信息
error.type	string	错误类型
error.param	string	相关参数
error.code	string	错误代码

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

提示：该接口用于查询异步视频生成任务的状态，建议采用轮询机制查询，当状态变为 completed 时，可通过 url 字段获取生成的视频文件地址。