12API logo12API
API 手册

Omni 视频生成

Omni 文生视频、图生视频和视频修改接口

Omni API 使用统一 /v1/videos 视频任务接口,支持文生视频、图生视频和视频修改。提交任务后通过轮询获取结果。

接口概览

能力方法路径
提交任务POST/v1/videos
查询任务GET/v1/videos/{task_id}

所有接口都使用:

Authorization: Bearer $API_KEY

可用模型

模型时长分辨率
omni_flash-10s10 秒720p

功能模式

模式传参方式
文生视频只传 prompt,不传参考素材
图生视频传 1 到 7 个图片 URL
视频修改在参考素材中传视频 URL,并可搭配图片 URL

请求参数

参数类型必填说明
modelstring固定使用 omni_flash-10s
promptstring视频提示词
sizestring例如 1280x720720x1280
imagesstring[]JSON 方式传图片或视频 URL,最多 7 项
input_reference[]repeatable表单方式传图片或视频 URL,最多 7 项

提交任务

curl https://cdn.12ai.org/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni_flash-10s",
    "prompt": "一段现代办公室产品展示视频,镜头平稳,光线明亮",
    "size": "1280x720"
  }'
curl https://cdn.12ai.org/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni_flash-10s",
    "prompt": "根据参考图生成自然运动的视频",
    "size": "1280x720",
    "images": [
      "https://example.com/img1.jpg",
      "https://example.com/img2.jpg"
    ]
  }'
curl https://cdn.12ai.org/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni_flash-10s",
    "prompt": "保持原视频运动节奏,把场景改成夜晚城市街道",
    "size": "1280x720",
    "images": [
      "https://example.com/source-video.mp4",
      "https://example.com/style-reference.jpg"
    ]
  }'

提交响应

{
  "id": "task_xxx",
  "status": "queued",
  "model": "omni_flash-10s",
  "created_at": 1760000000
}

查询任务

curl https://cdn.12ai.org/v1/videos/task_xxx \
  -H "Authorization: Bearer $API_KEY"

响应结构

字段类型说明
idstring任务 ID
statusstringqueuedprocessingcompletedfailed
progressnumber进度
video_urlstring完成后的视频 URL
errorobject失败原因

完成响应

{
  "id": "task_xxx",
  "status": "completed",
  "progress": 100,
  "video_url": "https://img.12ai.org/videos/task_xxx.mp4"
}

注意事项

项目说明
参考素材数量最多 7 项
文生视频不传 imagesinput_reference[]
图生视频参考素材传图片 URL
视频修改参考素材可包含视频 URL 和图片 URL

On this page