Skip to main content
POST

omni-fast

omni-fast 使用 JSON 请求体提交异步视频任务,适合文生视频、首帧图生视频、首尾帧和多参考图视频。
  • 异步处理模式,提交后返回 id 或 task_id。
  • 文生视频只需要 model、prompt、seconds 和画面比例字段。
  • 首帧图生视频使用 first_image_url。
  • 首尾帧使用 first_image_url 和 last_image_url。
  • 多参考图使用 images,最多 5 张;参考视频请使用 omni-fast-v2v。

方法与路径

请求示例

响应示例

认证

使用 Bearer Token 鉴权:
所有请求示例都需要携带 Authorization Header。JSON 请求还需要携带:

Body

string
必填
固定传 omni-fast。示例:"omni-fast"。
string
必填
视频提示词。示例:"Ocean waves gently rolling onto a sandy beach at golden hour"。
string
视频时长。建议传字符串;推荐范围为 4 到 30 秒。示例:"8"。
string
画面比例。示例值:"16:9"、"9:16"。
string
分辨率字段。示例值:"720p"、"1080p"、"2k"、"4k"。
string
首帧图。传入后进入首帧图生视频模式。支持公网 URL 或 data:image/...;base64,...。示例:"https://example.com/first-frame.jpg"。
string
尾帧图。需要配合 first_image_url 使用。示例:"https://example.com/last-frame.jpg"。
array<string>
多参考图列表,最多 5 张。支持公网 URL 或 data:image/...;base64,...。示例:["https://example.com/character.jpg"]。

Response

string
视频任务 ID。后续可用于 GET /v1/videos/{task_id} 查询。
string
视频任务 ID 的兼容字段。通常与 id 相同。
string
对象类型,通常为 video。
string
本次任务使用的模型,例如 omni-fast。
string
任务状态。常见值为 queued、in_progress、completed、failed。
number
任务进度,常见范围为 0 到 100。
string
完成后的视频地址。
object
任务失败或接口错误时返回的错误对象,通常包含 message 和 code。

使用场景

竖屏文生视频

首帧图生视频

多参考图视频

注意事项

  • omni-fast 不支持 video、video_url、input_video 参考视频字段。
  • images 最多 5 张。
  • 图片字段使用 JSON,不需要 multipart。
  • 建议轮询 GET /v1/videos/{task_id},完成后从返回的 video_url 获取生成的 MP4。
  • 参考视频编辑或延长必须使用 omni-fast-v2v。

相关接口