apimaxDocs
文档定价控制台
API 参考接入指南用户指南更新日志

音乐系列

图像系列

视频系列

POSTOmni Flash 视频生成

任务管理

错误码参考查询任务状态GET

账户管理

查询额度使用情况GET

文档 / 视频系列 / Omni Flash

Omni FlashPOSTomni-flash

Omni Flash 视频生成

omni-flash 视频生成(支持文生视频与图生视频,固定 720p):请求字段、JSON 与表单传参考图示例、提交异步任务、轮询状态、下载 MP4。

POSThttps://api.apimax.ai/v1/videos
试一试
Bearer API KeyJSON服务端调用

概述#

Omni Flash(Gemini Omni Flash)视频生成模型,支持文生视频与图生视频(参考图),固定 720p 输出,通过统一视频接口提交异步生成任务:提交成功后立即返回平台任务 ID,轮询到 completed 后,使用响应中的 url 下载 MP4。

本页对应的模型名是 omni-flash。模型名必须与请求体完全一致。

接口#

http
POST /v1/videos

请求需要携带 API Key:

http
Authorization: Bearer <token>
Content-Type: application/json

POST /v1/videos/generations 与 POST /v1/video/generations 为等价别名路径。

也可用通用任务接口 GET /v1/tasks/{task_id} 查询任务(见查询任务状态);POST /v1/responses 同样支持该模型(Responses 兼容格式,支持流式与后台任务)。

请求字段#

字段类型必填说明
modelstring是固定为 omni-flash
promptstring是视频内容、运动、镜头与风格描述
secondsinteger / string否视频时长,3 ~ 10 秒(整数逐秒),默认 3
duration 为兼容别名,seconds 优先
resolutionstring否仅支持 720p(默认);模型锁定 720p,请求 1080p 会被拒绝
sizestring否目标画布,格式 WIDTHxHEIGHT(如 1280x720,也认 720p 档位字面量)
短边映射后必须是 720p 档,否则拒绝;优先于 resolution
aspectstring否画面比例,16:9(默认)/ 9:16
ratio、aspect_ratio 为兼容别名,优先级 aspect > ratio > aspect_ratio
image_urls[]string / string否参考图,最多 3 张;数组为主形态,单串也收
条目两种形态:字符串——URL(http/https)或 base64(不含 data: 前缀);对象——{"url": "https://…"}(OpenAI 官方 videos 形态,其余键忽略,缺 url 键 400),数组内字符串与对象可混排
等价字段 ≡(完全同义、可混用、合并计数,合并序 reference → image_urls → images → image → reference_images → input_reference):reference、images、image、reference_images、input_reference(后两个为 OpenAI 官方 videos 名);multipart 文件 part 名同套,各配 [] 变体

尺寸映射#

传入 size 后按短边选择分辨率档位,omni-flash 仅接受 720p 档:

size实际分辨率
1280x720、720x1280720p
短边 ≥ 1080(如 1920x1080)拒绝(模型锁定 720p)

需要精确控制时直接传 resolution: "720p"。

参考图示例#

image_urls 与等价字段(reference 等)可混用(合计 ≤3 张):

json
{
  "model": "omni-flash",
  "prompt": "a corgi chasing butterflies under cherry blossoms",
  "image_urls": ["https://cdn.example.com/corgi.png"]
}

OpenAI 官方对象形态(reference_images,条目为 {"url": …} 对象,可与字符串形态混排):

json
{
  "model": "omni-flash",
  "prompt": "a corgi chasing butterflies under cherry blossoms",
  "reference_images": [
    { "url": "https://cdn.example.com/corgi.png" },
    { "url": "https://cdn.example.com/butterfly.png" }
  ]
}

需要竖版必须显式传 aspect: "9:16"(或竖图 size,如 720x1280);不带比例一律按 16:9 横版出片。

表单(multipart)模式#

Content-Type: multipart/form-data,文本字段与 JSON 入口同义:model / prompt / seconds / duration / resolution / size / aspect / ratio / aspect_ratio。参考图以二进制文件 part 传入,字段名与 JSON 侧同套:reference、image_urls、images、image、reference_images、input_reference,各可用 [] 数组风格写法(十二种拼法全收合并,合计 ≤3 张)。

cURL
curl --request POST \
  --url https://api.apimax.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --form model=omni-flash \
  --form prompt='a corgi chasing butterflies under cherry blossoms' \
  --form seconds=5 \
  --form aspect=16:9 \
  --form reference=@corgi.png

multipart 仅支持二进制文件 part:URL 或 base64 形态的参考图(字符串值)一律返回 400,请改走 JSON 入口对应字段。

提交任务#

完整参数示例:

cURL
curl --request POST \
  --url https://api.apimax.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "omni-flash",
    "prompt": "一只柯基犬在樱花树下追蝴蝶,明媚春光,轻快镜头",
    "seconds": 5,
    "resolution": "720p"
  }'

OpenAI 官方格式示例——seconds 用字符串形态、size 用像素形,与 OpenAI 视频接口(Sora 风格)一致,可直接用 OpenAI SDK 或官方示例代码对接:

cURL
curl --request POST \
  --url https://api.apimax.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "omni-flash",
    "prompt": "A corgi chasing butterflies under cherry blossoms, bright spring light",
    "seconds": "5",
    "size": "1280x720"
  }'

最简请求只传 model 与 prompt,时长/分辨率/比例取默认(3 秒、720p、16:9):

cURL
curl --request POST \
  --url https://api.apimax.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model": "omni-flash", "prompt": "一杯咖啡的热气特写,浅景深"}'

竖版(9:16)示例:

cURL
curl --request POST \
  --url https://api.apimax.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "omni-flash",
    "prompt": "竖屏运镜:樱花花瓣随风飘落",
    "aspect": "9:16",
    "seconds": 6
  }'

提交响应#

200
{
  "id": "task_NtOU1d2Pu9HkppPvEKQbXFR2k5f2UqVe",
  "object": "video",
  "model": "omni-flash",
  "status": "queued",
  "progress": 0,
  "created_at": 1791606210
}

id 为平台任务 ID,用于后续轮询与下载。

查询任务#

cURL
curl --request GET \
  --url https://api.apimax.ai/v1/videos/task_NtOU1d2Pu9HkppPvEKQbXFR2k5f2UqVe \
  --header 'Authorization: Bearer <token>'

任务状态:queued(排队)→ in_progress(生成中,progress 0 ~ 100)→ completed / failed。建议 5 ~ 10 秒间隔轮询。

完成响应示例:

200
{
  "id": "task_NtOU1d2Pu9HkppPvEKQbXFR2k5f2UqVe",
  "object": "video",
  "model": "omni-flash",
  "status": "completed",
  "progress": 100,
  "prompt": "一只柯基犬在樱花树下追蝴蝶,明媚春光,轻快镜头",
  "seconds": "5",
  "created_at": 1791606210,
  "completed_at": 1791606305,
  "url": "https://api.apimax.ai/v1/videos/task_NtOU1d2Pu9HkppPvEKQbXFR2k5f2UqVe/content"
}

下载视频#

url 即下载地址,返回 video/mp4,支持 Range 断点请求:

cURL
curl --request GET \
  --url https://api.apimax.ai/v1/videos/task_NtOU1d2Pu9HkppPvEKQbXFR2k5f2UqVe/content \
  --header 'Authorization: Bearer <token>' \
  -o video.mp4

计费#

按视频时长计费(固定 720p 输出,不分分辨率):提交时按请求时长预扣,任务完成后按实际时长结算。当前单价以平台「模型价格」页为准。

下一步

全部文档
Relink 音频链接根据 Suno clip_id 同步获取可直接使用的音频链接。润色风格标签把风格标签和歌词润色扩写成更完整的风格描述。获取风格灵感建议获取 Suno 上游的随机风格或灵感建议。方法一:从已有歌曲创建音色使用本池已生成的歌曲 clip 直接创建人声音色。上传音频把用户音频导入为 Suno 自有 clip，返回异步上传任务 ID；带 copyright=true 时改走版权音乐管线。查询额度使用情况使用 API Key 查询当前令牌及所属用户的剩余 credits、已用 credits 和无限额度状态。
本页导航
概览概述接口请求字段尺寸映射参考图示例表单(multipart)模式提交任务提交响应查询任务下载视频计费下一步
API

POST /v1/videos