用户媒体任务
分页查询当前登录用户通过 /submitGenerateMedia 创建的生图、生视频任务。接口按照提交批次下发数据：同一个 taskMark 的任务组成一个批次；taskMark 为空的历史任务各自作为独立批次。
请求URL：
/userMediaTask
请求方式：
- POST
header：
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Authorization | 是 | string | 授权Token，格式：Bearer {token} |
参数：
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | App唯一标识 |
| udid | 是 | string | 唯一设备ID |
| page | 否 | uint | 页码，从1开始，默认1 |
| pageSize | 否 | uint | 每页批次数量，默认20，最大100 |
请求示例：
{
"appId": "com.example.app",
"udid": "device-uuid",
"page": 1,
"pageSize": 20
}
返回示例：
{
"code": 200,
"msg": "SUCCESS",
"data": {
"list": [
{
"taskMark": "dbce9d14-d64f-44ef-a81f-66e75f509d62",
"paramsUser": {
"appId": "com.example.app",
"udid": "device-uuid",
"type": 1,
"modelId": 58,
"prompt": "A cinematic portrait, soft light",
"negativePrompt": "low quality, blurry",
"referenceImage": "",
"referenceImageResourceId": "",
"ratio": "1:1",
"width": 0,
"height": 0,
"steps": 30,
"cfgScale": 7.5,
"quantity": 2,
"seed": 123456,
"duration": 0,
"fps": 0
},
"taskList": [
{
"id": 790111,
"pid": 0,
"recordId": 0,
"dialogueId": 0,
"roleId": 0,
"type": 8,
"state": 30,
"path": "https://cdn.example.com/aiChat/media/original/image-2.jpg",
"thumbURL": "https://cdn.example.com/aiChat/media/thumb/image-2.jpg",
"reason": "",
"startTime": 1785398400,
"elapsedTime": 13,
"updatedAt": 1785398413
},
{
"id": 790110,
"pid": 0,
"recordId": 0,
"dialogueId": 0,
"roleId": 0,
"type": 8,
"state": 20,
"path": "",
"thumbURL": "",
"reason": "",
"startTime": 1785398400,
"elapsedTime": 3,
"updatedAt": 1785398403
}
]
},
{
"taskMark": "",
"paramsUser": null,
"taskList": [
{
"id": 790100,
"pid": 0,
"recordId": 0,
"dialogueId": 0,
"roleId": 0,
"type": 9,
"state": 2,
"path": "",
"thumbURL": "",
"reason": "generate video failed",
"startTime": 1785398000,
"elapsedTime": 5,
"updatedAt": 1785398005
}
]
}
],
"total": 2,
"page": 1,
"pageSize": 20
}
}
返回参数说明：
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 提示信息 |
| data | struct | 分页数据 |
| - list | array | 任务批次列表，按批次中最大任务ID倒序排列 |
| - total | int64 | 当前用户的任务批次总数，而非任务行总数 |
| - page | uint | 当前页码 |
| - pageSize | uint | 每页批次数量 |
| -- taskMark | string | 同批次任务标记；空字符串表示独立任务 |
| -- paramsUser | object/null | 用户提交 /submitGenerateMedia 时的请求参数；历史任务可能为null |
| -- taskList | array | 当前批次中的任务列表，批次内按任务ID倒序排列 |
| --- id | uint | 生图/生视频任务ID |
| --- pid | uint | 父任务ID；主动生成任务通常为0 |
| --- recordId | uint | 对话记录ID；主动生成任务固定为0 |
| --- dialogueId | uint | 会话ID；主动生成任务固定为0 |
| --- roleId | uint | 角色ID；主动生成任务固定为0 |
| --- type | uint8 | 主动生成任务类型：8-生图；9-生视频 |
| --- state | uint8 | 任务状态：2-失败；5-准备参数；10-等待执行；20-执行中；30-执行成功 |
| --- path | string | 生成文件完整地址；任务成功前通常为空 |
| --- thumbURL | string | 缩略图地址；暂无缩略图时为空 |
| --- reason | string | 失败原因；非失败状态通常为空 |
| --- startTime | int64 | 开始生成时间，Unix秒时间戳 |
| --- elapsedTime | uint | 生成耗时，单位秒 |
| --- updatedAt | int64 | 更新时间，Unix秒时间戳 |
paramsUser 字段与 /submitGenerateMedia 的JSON参数一致，可能包含以下字段：
| 参数名 | 类型 | 说明 |
|---|---|---|
| appId | string | App唯一标识 |
| udid | string | 唯一设备ID |
| type | uint8 | 请求生成类型：1-生图；2-生视频 |
| modelId | uint | 模型ID |
| prompt | string | 正向提示词 |
| negativePrompt | string | 负向提示词 |
| referenceImage | string | 用户传入的参考图URL |
| referenceImageResourceId | string | 用户传入的TensorArt资源ID |
| ratio | string | 图片或视频比例 |
| width | uint | 自定义宽度 |
| height | uint | 自定义高度 |
| steps | uint | 生图采样步数 |
| cfgScale | float | 生图提示词引导系数 |
| quantity | uint | 用户提交的生图数量 |
| seed | int64 | 随机种子 |
| duration | uint | 视频时长，单位秒 |
| fps | uint | 视频帧率 |
分组及分页规则：
/submitGenerateMedia的quantity大于1时，后台为本次创建的全部任务写入同一个非空taskMark；这些任务作为一个批次返回。- 单任务的
taskMark为空。所有空标记任务均独立成组，不会合并到同一个批次。 pageSize表示每页返回的批次数量，一个批次内可以包含多条taskList数据。- 接口仅返回当前登录用户的主动生图、主动生视频任务（类型8、9），包括准备、等待、执行中、成功和失败状态。
- 使用multipart上传的
image文件不会写入paramsUser；其他表单字段会按接口参数保存。旧任务没有保存用户请求参数时，paramsUser可能为null。 - 无数据时
code仍为200，msg为Have No Data，list返回空数组。
错误码：
- 510 系统异常
- 670 登录失效
- 800 参数错误