任务提交 API
概述
基础信息
基础URL
支持的端点
| 任务类型 | 请求地址 | 描述 |
|---|---|---|
| 图像/视频 | POST /v1/tasks/generations | 提交图像/视频生成任务 |
application/json请求结构
响应结构
基础响应结构
| 字段名 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
code | string | 是 | 响应状态码，"success" 表示成功 | "success" |
message | string | 是 | 响应消息，通常为空字符串 | "" |
data | object | 是 | 任务详细信息对象 | - |
任务信息字段 (data)
| 字段名 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
request_id | string | 是 | 请求的唯一标识符，用于后续查询任务状态 | "202508291629159482180006i9T0vui" |
task_id | string | 是 | 任务 ID，系统内部生成的任务标识符 | "" |
action | string | 是 | 任务类型 | "VIDEO_GENERATION" |
status | string | 是 | 任务状态，详见任务状态说明 | "SUBMITTING" |
fail_reason | string | 是 | 失败原因，任务成功时为空 | "" |
submit_time | number | 是 | 任务提交时间戳（Unix 时间戳，秒） | 1756456156 |
start_time | number | 是 | 任务开始处理时间戳（Unix 时间戳，秒） | 0 |
finish_time | number | 是 | 任务完成时间戳（Unix 时间戳，秒），未完成时为 0 | 0 |
progress | string | 是 | 任务进度百分比 | "0%" |
data | object | 是 | 任务结果数据对象，提交时通常为空 | {} |
任务类型说明
| 任务类型 | 描述 |
|---|---|
VIDEO_GENERATION | 视频生成任务 |
IMAGE_GENERATION | 图像生成任务 |
标准响应示例
视频生成任务提交成功响应
{
"code": "success",
"message": "",
"data": {
"request_id": "20250829203307450589000g8uiOTne",
"task_id": "",
"action": "VIDEO_GENERATION",
"status": "SUBMITTING",
"fail_reason": "",
"submit_time": 1756470787,
"start_time": 0,
"finish_time": 0,
"progress": "0%",
"data": {}
}
}图像生成任务提交成功响应
{
"code": "success",
"message": "",
"data": {
"request_id": "20250829203041325320000CFVslBwb",
"task_id": "",
"action": "IMAGE_GENERATION",
"status": "SUBMITTING",
"fail_reason": "",
"submit_time": 1756470641,
"start_time": 0,
"finish_time": 0,
"progress": "0%",
"data": {}
}
}提交失败响应
{
"code": "invalid_request",
"message": "prompt is required",
"data": null
}修改于 2025-09-12 06:26:16