Omni Flash 系列
omni-flash-ext 与 gemini-omni-flash-preview:文生、参考视频驱动、图生与视频编辑,异步,按条计费,用 GET /v1/tasks/{task_id} 查询
本页包含两个模型:omni-flash-ext 支持分辨率/时长档位与参考视频驱动生成;gemini-omni-flash-preview 固定 720p、无需指定时长,支持文生视频、图生视频(参考图)、视频编辑(参考视频)与多轮续作编辑。提交、轮询、任务对象与错误见接口说明。
| 项 | 值 |
|---|---|
| 模型 | omni-flash-ext、gemini-omni-flash-preview |
| 模式 | 异步(提交 → 轮询 GET /v1/tasks/{task_id}) |
| 计费 | 按单次任务(条)固定扣费,与实际输出时长无关,见计费 |
| 媒体保留 | video_url 最长保留至任务完成后 72 小时 |
| 模型 | 时长 | 分辨率 | 默认值 |
|---|---|---|---|
omni-flash-ext | 4、6、8、10 秒(枚举) | 720p、1080p、4k | 6 秒、720p |
gemini-omni-flash-preview | 不支持指定时长,输出约 3–10 秒由模型决定 | 固定 720p | 720p |
快速开始
omni-flash-ext 按枚举时长生成:
curl https://api.vibelab.me/v1/videos/generations \
-H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "omni-flash-ext",
"prompt": "工作室里的产品旋转展示,柔光打底",
"resolution": "720p",
"duration": 8
}'响应示例(HTTP 202):
{
"task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
"model": "omni-flash-ext",
"status": "pending",
"created_at": 1772942400,
"duration": 8,
"resolution": "720p"
}用 task_id 调用 GET /v1/tasks/{task_id} 查询,见响应。
模式选择
| 模式 | 模型 | 怎么传参 |
|---|---|---|
| 文生视频(枚举时长) | omni-flash-ext | prompt + resolution + duration |
| 参考视频驱动 | omni-flash-ext | video_urls,不传 duration,按参考视频档位计费 |
| 文生视频 | gemini-omni-flash-preview | 只传 prompt |
| 图生视频 | gemini-omni-flash-preview | image_urls(最多 16 张) |
| 视频编辑 | gemini-omni-flash-preview | video_urls(最多 1 个) |
| 多轮续作 | gemini-omni-flash-preview | extend_from_task_id,与 video_urls 互斥 |
请求参数
omni-flash-ext
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
model | string | 是 | - | 固定为 omni-flash-ext |
prompt | string | 是 | - | 视频内容描述 |
resolution | string | 否 | 720p | 720p、1080p 或 4k |
duration | integer | 否 | 6 | 4、6、8、10 之一;不能与 video_urls 同时使用 |
video_urls | string[] | 否 | - | 参考视频 URL,用于驱动生成;与 duration 互斥,出现该字段按参考视频档位计费 |
generation_type | string | 否 | 按输入自动判断 | 生成模式,配合 video_urls 使用,如按首尾帧(frame)或按参考视频驱动(reference)解析输入 |
callback_url | string | 否 | - | 任务到达终态后的 HTTPS 回调地址 |
gemini-omni-flash-preview
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
model | string | 是 | - | 固定为 gemini-omni-flash-preview |
prompt | string | 是 | - | 场景描述或编辑指令 |
image_urls | string[] | 否 | - | 参考图 URL,最多 16 张(JPEG/PNG),用于图生视频 |
video_urls | string[] | 否 | - | 参考视频 URL,最多 1 个(时长 1–24 秒,建议不超过 3 秒),用于视频编辑;与 extend_from_task_id 互斥 |
aspect_ratio | string | 否 | 16:9 | 16:9(横屏)或 9:16(竖屏) |
extend_from_task_id | string | 否 | - | 传入上一次任务 ID 进行多轮续作编辑;与 video_urls 互斥 |
callback_url | string | 否 | - | 任务到达终态后的 HTTPS 回调地址 |
该模型 resolution 仅接受 720p(可省略),不支持 duration(输出时长由模型自行决定)。输出视频为 720p、24fps,自带音频。
请求示例
omni-flash-ext 参考视频驱动(不传 duration):
{
"model": "omni-flash-ext",
"prompt": "沿用参考视频的镜头运动,主体替换为一辆红色跑车",
"resolution": "1080p",
"video_urls": ["https://example.com/ref.mp4"]
}gemini-omni-flash-preview 文生视频:
{
"model": "gemini-omni-flash-preview",
"prompt": "夕阳下的海边,海鸥掠过水面"
}gemini-omni-flash-preview 图生视频(参考图 + 运动描述):
{
"model": "gemini-omni-flash-preview",
"prompt": "让画面中的人物转身走向远处",
"image_urls": ["https://example.com/ref.png"],
"aspect_ratio": "9:16"
}响应
用 GET /v1/tasks/{task_id} 查询,状态依次为 pending → running → succeeded / failed(终态)。
| 字段 | 类型 | 说明 |
|---|---|---|
status | string | pending、running、succeeded、failed |
video_url | string | 视频下载地址,仅 succeeded 返回,尽快转存 |
expires_at | integer | video_url 失效时间,Unix 秒 |
credits_charged | number | 本次实际扣费(积分) |
error | object | 仅 failed 返回:{"code": "timeout" | "upstream_error", "message": "..."} |
完整任务对象字段与示例见接口说明。extend_from_task_id 传入的是这里返回的 task_id。
计费
两个模型均按单次任务(条)固定扣费,与实际输出时长无关。
omni-flash-ext 价格取决于分辨率与时长档位:
| 分辨率 | 4 秒 | 6 秒 | 8 秒 | 10 秒 |
|---|---|---|---|---|
720p(默认) | 约 3 积分/条 | 约 3.6 积分/条 | 约 4.2 积分/条 | 约 4.8 积分/条 |
1080p | 约 3 积分/条 | 约 3.6 积分/条 | 约 4.2 积分/条 | 约 4.8 积分/条 |
4k | 约 9 积分/条 | 约 9.6 积分/条 | 约 10.2 积分/条 | 约 10.8 积分/条 |
传入 video_urls(参考视频驱动,不含 duration)时按固定档位计费:720p/1080p 约 0.96 积分/条,4k 约 2.88 积分/条。
gemini-omni-flash-preview 固定约 9.74 积分/条。
精确价格与实时变动以定价页为准。
错误
通用错误见接口说明。本模型提交时的参数校验返回 400 invalid_request_error:
message | 触发场景 | 处理 |
|---|---|---|
resolution must be one of 720p/1080p/4k | omni-flash-ext 分辨率取值不在范围内 | 改用 720p、1080p 或 4k |
resolution must be one of 720p | gemini-omni-flash-preview 传了非 720p | 省略或传 720p |
duration must be one of 4/6/8/10 | omni-flash-ext 时长不是枚举值(含非整数) | 传 4、6、8、10 |
duration cannot be used together with video_urls | omni-flash-ext 同时传 duration 与 video_urls | 二选一 |
注意事项
omni-flash-ext 的 duration 与 video_urls 互斥:请求中同时出现两者会返回 400 invalid_request_error。
gemini-omni-flash-preview的video_urls与extend_from_task_id→ 互斥,二选一。gemini-omni-flash-preview传duration→ 不支持,输出时长由模型决定。