Gemini Omni Flash Ext

模型名称：gemini-omni-flash-ext

面向更高规格的多模态视频生成、三图融合和参考视频扩展场景
default / standard 两个分组均可用，参数范围和请求体一致
当前仅开放接口调用入口
提交成功后返回视频任务 ID
支持文生视频、单图/三图参考视频和单参考视频模式
images 当前稳定口径支持 0 / 1 / 3 张
video_urls 当前最多 1 条
duration 支持 4 / 6 / 8 / 10 秒
size 支持 16:9 / 9:16
resolution 支持 720p / 1080p / 4k

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。

Authorization: Bearer YOUR_API_KEY

提交任务接口

POST /v1/videos

请求参数

字段	类型	必填	默认值	说明
`model`	`string`	是	-	固定传 `gemini-omni-flash-ext`
`prompt`	`string`	是	-	视频生成提示词
`n`	`number`	否	`1`	当前仅支持传 `1`
`images`	`string[]`	否	-	参考图地址数组，当前只支持 `0 / 1 / 3` 张
`video_urls`	`string[]`	否	-	参考视频地址数组，当前最多 `1` 条
`duration`	`number`	否	`4`	支持 `4 / 6 / 8 / 10`
`size`	`string`	否	`16:9`	支持 `16:9 / 9:16`
`resolution`	`string`	否	`720p`	支持 `720p / 1080p / 4k`
`generation_type`	`string`	否	-	参考图模式可选 `frame` 或 `reference`

分组参数说明

default / standard 两个分组共用以下稳定公开能力，切换分组时不需要修改请求体：

能力项	当前口径
文生视频	支持
图生视频	支持 `1` 张或 `3` 张参考图
参考视频	支持传 `1` 条 `video_urls`
`generation_type=frame`	必须恰好传 `1` 张图
`generation_type=reference`	只支持 `1` 或 `3` 张图

响应

{
  "id": "video_task_01KQEXAMPLE_GEMINI_OMNI_FLASH_EXT",
  "object": "video",
  "model": "gemini-omni-flash-ext",
  "status": "queued",
  "progress": 0,
  "created_at": 1711111111
}

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "参数错误，请检查 prompt、images、video_urls、duration、size、resolution 或 generation_type 是否符合当前模型要求"
  }
}

任务查询接口

GET /v1/videos/{task_id}

{
  "id": "video_task_01KQEXAMPLE_GEMINI_OMNI_FLASH_EXT",
  "object": "video",
  "model": "gemini-omni-flash-ext",
  "status": "completed",
  "progress": 100,
  "result_url": "https://example.com/result/gemini-omni-flash-ext.mp4"
}

使用示例

文生视频

curl --request POST \
  --url https://api.aimaxa.cn/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-omni-flash-ext",
    "prompt": "生成一段商品展示镜头，镜头推进并带轻微转场",
    "duration": 8,
    "size": "16:9",
    "resolution": "720p"
  }'

三图参考视频

curl --request POST \
  --url https://api.aimaxa.cn/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-omni-flash-ext",
    "prompt": "把三张参考图融合成一段空间连续、镜头稳定推进的视频",
    "images": [
      "https://example.com/reference-1.jpg",
      "https://example.com/reference-2.jpg",
      "https://example.com/reference-3.jpg"
    ],
    "duration": 8,
    "size": "16:9",
    "resolution": "1080p",
    "generation_type": "reference"
  }'

参考视频模式

curl --request POST \
  --url https://api.aimaxa.cn/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-omni-flash-ext",
    "prompt": "参考原视频镜头运动和色调，生成一个更未来感的版本",
    "video_urls": [
      "https://example.com/reference-video.mp4"
    ],
    "size": "16:9",
    "resolution": "720p"
  }'

注意事项

images 当前只放行 0 / 1 / 3。
video_urls 当前最多 1 条。
generation_type=frame 时必须传 1 张图；generation_type=reference 时只支持 1 或 3 张图。
提交成功后请使用 GET /v1/videos/{task_id} 继续轮询结果。

异步状态与失败响应

视频任务状态只使用 queued、in_progress、completed、failed。处于 queued 或 in_progress 时继续调用查询接口；只有 completed 状态才读取顶层 result_url。任务失败时保持视频对象结构，并返回顶层 error 与 fail_reason，不要按图片接口读取 code/data/works：

{
  "id": "video_task_01KQEXAMPLE_FAILED",
  "object": "video",
  "model": "gemini-omni-flash-ext",
  "status": "failed",
  "progress": 100,
  "error": {
    "code": "task_failed",
    "message": "请求处理失败，请稍后重试"
  },
  "fail_reason": "请求处理失败，请稍后重试"
}

开始使用

图像模型

视频模型

文本模型

Gemini Omni Flash Ext

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

文生视频

三图参考视频

参考视频模式

注意事项

异步状态与失败响应

​请求鉴权

​提交任务接口

​请求参数

​分组参数说明

​响应

​任务查询接口

​使用示例

​文生视频

​三图参考视频

​参考视频模式

​注意事项

​异步状态与失败响应

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

文生视频

三图参考视频

参考视频模式

注意事项

异步状态与失败响应