Xing-Video2.0 回告数据结构(算法编码：8005400045)

协议类型：HTTPS

接口类型：Xing-Video2.0-回告数据结构

---

一、接口信息

项目	内容
API Path	/
请求协议	HTTPS
请求方法	POST

---

二、响应内容

返回结果

成功 (200)

Json

Object

2.1 顶层字段

参数名	说明	必填	类型
seq_id	请求序列号，同输入的 seq_id	是	string
send_pts_ms	时间戳	是	long
code	状态响应码，参考错误编码规范	是	string
message	调用结果描述，参考错误编码规范	是	string
task_id	算法能力编号，同输入的 task_id	是	int
flag	业务上成功或失败：1 成功，0 失败	是	int
data	返回结果	是	object

2.2 返回结果 data

参数名	说明	必填	类型
status	状态：0 未开始；1 执行中；2 执行成功；3 执行失败	是	int
task_result	任务执行结果，code 码不是 10000 时此字段为空字典	是	object

2.3 任务执行结果 task_result

参数名	说明	必填	类型
out_video	结果视频，["http://***.mp4"]，返回存放 mp4 数据的 url 地址，或本地 mp4 文件地址，生成失败则返回空列表。结果资源获取请参见开发指南 - 异步调用结果获取 - 获取大模型生成结果文件信息。	是	array
out_text	实际使用的 prompt ["xxxxxxxxxx"]，返回生成视频实际使用的 prompt，可能与原始数据相同也可能经过提示词增强，生成失败则返回空列表	否	array
out_extra_message	扩展参数列表，填充规则见 2.4 响应扩展参数说明	否	array

2.4 响应扩展参数 out_extra_message

out_extra_message 为数组，数组元素为 key（参数名）、value（参数值）组成的键值对，可用的参数如下：

参数中文名	参数名称（key）	内部数据类型	备注
视频画面的长	width	int	像素数，例如 1080
视频画面的宽	height	int	像素数，例如 1080
视频帧率	fps	float	例如 30.0
视频生成时长	duration	int	例如 5.0
折算系数	conversion_factor	float	星辰视频生成固定 1.5

成功示例 [Mock API]：

{
  "seq_id": "5183b530-4c0c-11f0-b384-61e09dc788ee",
  "send_pts_ms": 1750239877,
  "code": "10000",
  "message": "服务执行成功",
  "flag": 1,
  "task_id": 30012,
  "data": {
    "status": 2,
    "task_result": {
      "out_video": ["http://***.mp4"],
      "out_text": ["xxxxx"],
      "out_extra_message": [
        {
          "key": "width",
          "value": 1024
        },
        {
          "key": "height",
          "value": 1024
        },
        {
          "key": "fps",
          "value": 24.0
        },
        {
          "key": "duration",
          "value": 5.0
        },
        {
          "key": "conversion_factor",
          "value": 1.5
        }
      ]
    }
  }
}

失败示例 [Mock API]：

{
  "seq_id": "a504324c-6e10-11f0-b384-61e09dc788ee",
  "send_pts_ms": "1710315626154",
  "code": "10903",
  "message": "服务执行失败",
  "flag": 0,
  "task_id": 30012
}

---

三、详细说明

3.1 修订历史

日期	版本	修订内容
2026-10-12	v1.0.1	修复显存泄漏问题，增加计费接口，增加健康检查探针
2026-09-11	v1.0.0	初始化 API 文档，支持文生视频，图生视频（首帧生视频），首尾帧生视频

3.2 回告规范

最终处理结果回告方式遵循异步调用结果回告协议规范，回调结果见上面响应结果。