LoopToken

Omni Flash 系列

omni-flash-ext 与 gemini-omni-flash-preview:文生、参考视频驱动、图生与视频编辑,异步,按条计费,用 GET /v1/tasks/{task_id} 查询

POST/v1/videos/generations
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-ext4、6、8、10 秒(枚举)720p、1080p、4k6 秒、720p
gemini-omni-flash-preview不支持指定时长,输出约 3–10 秒由模型决定固定 720p720p

快速开始

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-extprompt + resolution + duration
参考视频驱动omni-flash-extvideo_urls,不传 duration,按参考视频档位计费
文生视频gemini-omni-flash-preview只传 prompt
图生视频gemini-omni-flash-previewimage_urls(最多 16 张)
视频编辑gemini-omni-flash-previewvideo_urls(最多 1 个)
多轮续作gemini-omni-flash-previewextend_from_task_id,与 video_urls 互斥

请求参数

omni-flash-ext

参数类型必填默认说明
modelstring是-固定为 omni-flash-ext
promptstring是-视频内容描述
resolutionstring否720p720p、1080p 或 4k
durationinteger否64、6、8、10 之一;不能与 video_urls 同时使用
video_urlsstring[]否-参考视频 URL,用于驱动生成;与 duration 互斥,出现该字段按参考视频档位计费
generation_typestring否按输入自动判断生成模式,配合 video_urls 使用,如按首尾帧(frame)或按参考视频驱动(reference)解析输入
callback_urlstring否-任务到达终态后的 HTTPS 回调地址

gemini-omni-flash-preview

参数类型必填默认说明
modelstring是-固定为 gemini-omni-flash-preview
promptstring是-场景描述或编辑指令
image_urlsstring[]否-参考图 URL,最多 16 张(JPEG/PNG),用于图生视频
video_urlsstring[]否-参考视频 URL,最多 1 个(时长 1–24 秒,建议不超过 3 秒),用于视频编辑;与 extend_from_task_id 互斥
aspect_ratiostring否16:916:9(横屏)或 9:16(竖屏)
extend_from_task_idstring否-传入上一次任务 ID 进行多轮续作编辑;与 video_urls 互斥
callback_urlstring否-任务到达终态后的 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(终态)。

字段类型说明
statusstringpending、running、succeeded、failed
video_urlstring视频下载地址,仅 succeeded 返回,尽快转存
expires_atintegervideo_url 失效时间,Unix 秒
credits_chargednumber本次实际扣费(积分)
errorobject仅 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/4komni-flash-ext 分辨率取值不在范围内改用 720p、1080p 或 4k
resolution must be one of 720pgemini-omni-flash-preview 传了非 720p省略或传 720p
duration must be one of 4/6/8/10omni-flash-ext 时长不是枚举值(含非整数)传 4、6、8、10
duration cannot be used together with video_urlsomni-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 → 不支持,输出时长由模型决定。

本页内容