Omni 视频生成（omni_flash-10s）

Omni 视频生成

Omni 系列视频生成接口，支持文生视频、图生视频（参考图）、视频修改三种能力。接口地址 POST /v1/videos，为异步任务，提交后轮询查询结果。暂不支持首尾帧模式。

可用模型

模型名	时长	分辨率	用途
`omni_flash-10s`	10s	720p	文生视频 / 图生视频（参考图最多 7 张）/ 视频修改，横竖屏均支持

模型名已包含时长与分辨率规格。后续将新增更多分辨率与时长档位，字段用法不变。

请求方式

支持两种，任选其一：

方式	Content-Type	参考图 / 源视频字段
JSON	`application/json`	`images` 字符串数组（图片或视频的 URL / Base64 data URI）
表单	`multipart/form-data`	`input_reference` 可重复字段，每项一张图或一个视频文件（本地文件 / URL / Base64）

JSON 模式用 images，表单模式用 input_reference，两者不可混用。

请求头

参数	必填	说明
Authorization	是	`Bearer <YOUR_API_KEY>`
Content-Type	是	`application/json` 或 `multipart/form-data`，须与请求体一致

请求参数

参数	类型	必填	说明
model	string	是	`omni_flash-10s`
prompt	string	是	文本提示词
size	string	否	视频尺寸，格式 `宽x高`，如 `1280x720`（横）/ `720x1280`（竖）。默认 720p；宽大于高为横屏，高大于宽为竖屏
images	string[]	否	JSON 模式参考图 / 源视频数组，最多 7 项。图片传 URL 或 Base64 data URI；视频修改传源视频直链 URL
input_reference	可重复	否	表单模式参考图 / 源视频，同名字段可重复，最多 7 项。支持本地文件（`@路径`）、公网直链、Base64 data URI；视频修改可直接上传本地视频文件

请求示例

文生视频（JSON）：

文生视频（表单）：

图生视频 · 参考图 · URL（JSON）：

图生视频 · 参考图 · URL（表单）：

图生视频 · 参考图 · 本地文件（表单，最多 7 张）：

Windows cmd（curl.exe 用 ^ 换行）：

curl.exe -X POST "https://cdn.wusag.com/v1/videos" ^
  -H "Authorization: Bearer <YOUR_API_KEY>" ^
  -F "model=omni_flash-10s" ^
  -F "prompt=根据参考图生成视频" ^
  -F "size=1280x720" ^
  -F "input_reference=https://example.com/ref1.jpg" ^
  -F "input_reference=https://example.com/ref2.jpg"

视频修改 · 源视频 URL（JSON）：

视频修改 · 本地视频文件（表单）：

Python（表单，图生视频）：

响应参数

参数	类型	说明
id / task_id	string	任务 ID
object	string	固定值 `video`
model	string	模型名 `omni_flash-10s`
status	string	`queued`（排队中）/ `in_progress`（处理中）/ `completed`（已完成）/ `failed`（失败）
progress	number	进度 0~100
size	string	视频尺寸
created_at	number	创建时间戳（秒）
completed_at	number	完成时间戳（秒，`completed` 时返回）
video_url	string	视频直链（`completed` 时返回）
error	object	错误信息（`failed` 时返回），含 `code`、`message`

响应示例

提交成功（排队中）：

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "omni_flash-10s",
  "status": "queued",
  "progress": 0,
  "size": "1280x720",
  "created_at": 1780256638
}

任务完成：

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "omni_flash-10s",
  "status": "completed",
  "progress": 100,
  "size": "1280x720",
  "created_at": 1780256638,
  "completed_at": 1780256713,
  "video_url": "https://example.com/videos/output.mp4"
}

任务失败：

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "omni_flash-10s",
  "status": "failed",
  "progress": 0,
  "created_at": 1780256638,
  "error": {
    "code": "content_policy_violation",
    "message": "内容违反使用政策"
  }
}

查询任务状态

GET /v1/videos/{task_id}，返回字段同上，completed 后包含 video_url。也可用 GET /v1/videos/{task_id}/content 直接下载视频文件（返回 video/mp4）。

注意事项

模型名即完整规格：omni_flash-10s 表示 flash 质量、10 秒、720p。

size 格式 宽x高：宽大于高为横屏（16:9），高大于宽为竖屏（9:16）。推荐 1280x720（横屏 720p）、720x1280（竖屏 720p）；后续高清档位可用 1920x1080、1080x1920。

参考图 / 源视频最多 7 项，超出忽略。文件数量越多、单个文件越大，上传耗时越长。

视频修改：JSON 模式用 images 传源视频直链 URL；表单模式可用 input_reference 直接上传本地视频文件。JSON 不支持直接附带视频文件，传本地视频请用表单方式。

JSON 与表单二选一：JSON 用 images 数组，表单用可重复的 input_reference，不可混用。

images 或 input_reference 中的 URL 须为可公网访问的直链（直接返回文件内容），不要传需要登录的网页地址。

暂不支持首尾帧模式。

异步接口：提交成功仅返回任务 ID，需轮询 GET /v1/videos/{task_id} 获取进度与结果。

错误码

code	原因
`generation_error`	生成失败，可重试
`content_policy_violation`	内容违反使用政策

application/json

提交成功

Bodyapplication/json

示例

{
    "id": "string",
    "task_id": "string",
    "object": "string",
    "model": "string",
    "status": "string",
    "progress": 0,
    "size": "string",
    "created_at": 0,
    "completed_at": 0,
    "video_url": "string",
    "error": {
        "code": "string",
        "message": "string"
    }
}