查询视频

GET  v1/video/generations/{task_id}

请求参数

Authorization

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 Token。

Authorization: Bearer ******************

Path 参数

字段名	类型	必填	说明
task_id	string	必需	任务id

返回响应

200 成功

Content-Type: application/json

响应参数

字段名	类型	必填	说明
id	string	必需	任务 ID。该绘画任务的唯一标识符。
action	string	必需	操作类型。例如 IMAGINE（生成）、UPSCALE（放大）、VARIATION（变体）等。
status	string	必需	当前状态。如 SUBMITTED（已提交）、IN_PROGRESS（进行中）、SUCCESS（成功）、FAILURE（失败）。
state	string	必需	内部状态。通常用于传递自定义的上下文或追踪状态。
progress	string	必需	生成进度。例如 "100%" 或具体的百分比字符串。
prompt	string	必需	原始提示词。用户提交的原始 Prompt 文本。
promptEn	string	必需	英文提示词。经过翻译或处理后的英文 Prompt。
description	string	必需	任务描述。对当前任务状态的简短文字说明。
imageUrl	string	必需	图片链接。生成结果的图片 URL 地址。
failReason	string	必需	失败原因。如果任务失败，这里会包含具体的错误信息；成功则为空。
submitTime	integer	必需	提交时间戳。任务被提交时的 Unix 时间戳。
startTime	integer	必需	开始时间戳。任务正式开始处理的时间戳。
finishTime	integer	必需	完成时间戳。任务结束（无论成功或失败）的时间戳。
properties	object	必需	属性对象。包含任务的额外配置或元数据信息。
buttons	array [object]	必需	交互按钮。返回可供下一步操作的按钮数组（如 U1-U4, V1-V4 等）。
├─ customId	string	可选	按钮的唯一标识符，用于回调操作。
├─ emoji	string	可选	按钮上显示的 Emoji 图标。
├─ label	string	可选	按钮上显示的文字标签。
├─ style	integer	可选	按钮的样式代码（如主要、次要等）。
└─ type	integer	可选	按钮的类型代码。

响应示例

{
    "action": "IMAGINE",
    "buttons": [
        {
            "customId": "string",
            "emoji": "string",
            "label": "string",
            "style": 0,
            "type": 0
        }
    ],
    "description": "string",
    "failReason": "string",
    "finishTime": 0,
    "id": "string",
    "imageUrl": "string",
    "progress": "string",
    "prompt": "string",
    "promptEn": "string",
    "properties": {},
    "startTime": 0,
    "state": "string",
    "status": "NOT_START",
    "submitTime": 0
}

示例代码

import http.client
import json

conn = http.client.HTTPSConnection("nxaiapp.com")
payload = json.dumps({})
headers = {
   'Authorization': 'Bearer <token>',
   'Content-Type': 'application/json'
}
conn.request("GET", "/v1/video/generations/", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))