> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Gemini Omni 1.2 Flash 全参数总览 > - Gemini Omni 1.2 Flash 通过统一的 `POST /v1/videos/generations` 入口提供六种视频任务 - **文生视频：** `gemini-omni-1.2-flash-text-to-video`，仅需文本提示词，时长 `3~15` 秒 - **图生视频：** `gemini-omni-1.2-flash-image-to-video`，支持 1 张首帧图（`3~15` 秒）或 2 张首尾帧图（`3~10` 秒） - **参考生视频：** `gemini-omni-1.2-flash-reference-to-video`，支持参考图和最多 3 个参考视频，`duration` 大于 10 秒时最多 1 个参考视频 - **视频编辑：** `gemini-omni-1.2-flash-video-edit`，需要 1 个最长 15 秒的输入视频，可额外传入最多 10 张参考图，`quality` 默认 `auto` - **视频扩展：** `gemini-omni-1.2-flash-video-extend`，需要 1 个最长 30 秒的视频，可额外传入最多 10 张参考图，`quality` 默认 `auto`，`duration` 表示追加秒数 - **视频超分辨率：** `gemini-omni-1.2-flash-video-upscale`，需要 1 个最长 15 秒的标准尺寸视频，通过 `quality` 指定目标分辨率，无需提示词 - **画面比例：** 默认 `auto`；视频编辑、视频扩展和视频超分辨率的输出比例跟随输入视频 - **原生音频：** 模型自动生成同步音频，无需额外开关 - **随机种子：** 通过 `seed` 固定随机种子，便于复现生成结果 - 异步处理模式，使用返回的任务 ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的视频链接有效期为 24 小时，请尽快保存 ## OpenAPI ````yaml cn/api-manual/video-series/gemini-omni-1.2-flash/gemini-omni-1.2-flash-overview.json POST /v1/videos/generations openapi: 3.1.0 info: title: Gemini Omni 1.2 Flash 全参数接口 description: Gemini Omni 1.2 Flash 全参数总览，覆盖文生视频、图生视频、参考生视频、视频编辑、视频扩展和视频超分辨率六种模式 license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: 生产环境 security: - bearerAuth: [] paths: /v1/videos/generations: post: tags: - 视频生成 summary: Gemini Omni 1.2 Flash 全参数接口 description: >- - Gemini Omni 1.2 Flash 通过统一的 `POST /v1/videos/generations` 入口提供六种视频任务 - **文生视频：** `gemini-omni-1.2-flash-text-to-video`，仅需文本提示词，时长 `3~15` 秒 - **图生视频：** `gemini-omni-1.2-flash-image-to-video`，支持 1 张首帧图（`3~15` 秒）或 2 张首尾帧图（`3~10` 秒） - **参考生视频：** `gemini-omni-1.2-flash-reference-to-video`，支持参考图和最多 3 个参考视频，`duration` 大于 10 秒时最多 1 个参考视频 - **视频编辑：** `gemini-omni-1.2-flash-video-edit`，需要 1 个最长 15 秒的输入视频，可额外传入最多 10 张参考图，`quality` 默认 `auto` - **视频扩展：** `gemini-omni-1.2-flash-video-extend`，需要 1 个最长 30 秒的视频，可额外传入最多 10 张参考图，`quality` 默认 `auto`，`duration` 表示追加秒数 - **视频超分辨率：** `gemini-omni-1.2-flash-video-upscale`，需要 1 个最长 15 秒的标准尺寸视频，通过 `quality` 指定目标分辨率，无需提示词 - **画面比例：** 默认 `auto`；视频编辑、视频扩展和视频超分辨率的输出比例跟随输入视频 - **原生音频：** 模型自动生成同步音频，无需额外开关 - **随机种子：** 通过 `seed` 固定随机种子，便于复现生成结果 - 异步处理模式，使用返回的任务 ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的视频链接有效期为 24 小时，请尽快保存 operationId: createGeminiOmni12FlashGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GeminiOmni12FlashRequest' examples: text_to_video: summary: 文生视频 value: model: gemini-omni-1.2-flash-text-to-video prompt: 一颗玻璃弹珠在木质轨道上快速滚动，最后落入水中溅起水花 quality: 720p duration: 3 aspect_ratio: '16:9' image_to_video: summary: 首尾帧图生视频 value: model: gemini-omni-1.2-flash-image-to-video prompt: 镜头从日出平滑过渡到夜晚灯火 image_urls: - https://example.com/first-frame.png - https://example.com/last-frame.png quality: 720p duration: 3 aspect_ratio: '16:9' reference_to_video: summary: 图片与视频参考生视频 value: model: gemini-omni-1.2-flash-reference-to-video prompt: 保持参考图中的人物外观，并参考视频中的镜头运动 image_urls: - https://example.com/character.png video_urls: - https://example.com/reference.mp4 quality: 720p duration: 3 aspect_ratio: '16:9' video_edit: summary: 视频编辑 value: model: gemini-omni-1.2-flash-video-edit prompt: 将整体光线调整为温暖的日落氛围，其余内容保持不变 video_urls: - https://example.com/source.mp4 quality: auto duration: auto aspect_ratio: auto video_extend: summary: 视频扩展 value: model: gemini-omni-1.2-flash-video-extend prompt: 人物继续向前走，缓缓走出画面 video_urls: - https://example.com/source.mp4 duration: 3 quality: auto aspect_ratio: auto video_upscale: summary: 视频超分辨率 value: model: gemini-omni-1.2-flash-video-upscale video_urls: - https://example.com/source-720p.mp4 quality: 1080p responses: '200': description: 视频任务创建成功 content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: 请求参数错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: 未认证、Token无效或过期 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: 配额不足、需要充值 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: 无权限访问 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: >- Token does not have access to model: gemini-omni-1.2-flash-text-to-video type: invalid_request_error '429': description: 请求频率超限 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: 服务器内部错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: GeminiOmni12FlashRequest: type: object required: - model additionalProperties: false properties: model: type: string description: |- 模型名称。必须根据输入素材和任务类型选择对应的模型 ID： - `gemini-omni-1.2-flash-text-to-video`：文生视频 - `gemini-omni-1.2-flash-image-to-video`：图生视频（首帧或首尾帧） - `gemini-omni-1.2-flash-reference-to-video`：参考生视频 - `gemini-omni-1.2-flash-video-edit`：视频编辑 - `gemini-omni-1.2-flash-video-extend`：视频扩展 - `gemini-omni-1.2-flash-video-upscale`：视频超分辨率 enum: - gemini-omni-1.2-flash-text-to-video - gemini-omni-1.2-flash-image-to-video - gemini-omni-1.2-flash-reference-to-video - gemini-omni-1.2-flash-video-edit - gemini-omni-1.2-flash-video-extend - gemini-omni-1.2-flash-video-upscale example: gemini-omni-1.2-flash-text-to-video prompt: type: string description: |- 描述生成、编辑或续写目标的文本提示词，支持中英文。视频超分辨率以外的模式必填，视频超分辨率无需提示词。 **使用建议：** - 清楚描述主体、动作、场景、镜头运动和需要保持不变的内容 - 负面要求直接写入提示词（例如 `No dialogue`、`不要出现文字`），本模型不提供独立的负面提示词参数 视频超分辨率不使用 `prompt`；传入的提示词会被忽略。 example: 一颗玻璃弹珠在木质轨道上快速滚动，最后落入水中溅起水花 image_urls: type: array items: type: string format: uri minItems: 1 maxItems: 10 description: |- 图片输入数组 - 图生视频：必填，支持 1～2 张；1 张为首帧，2 张为首帧和尾帧 - 参考生视频：必填，公开建议最多 10 张参考图 - 视频编辑：可选，最多 10 张参考图 - 视频扩展：可选，最多 10 张参考图 - 文生视频、视频超分辨率：不支持图片输入 仅支持 HTTP/HTTPS 图片 URL；格式支持 `png`、`jpeg`、`webp` example: - https://example.com/character.png - https://example.com/scene.png video_urls: type: array items: type: string format: uri minItems: 1 maxItems: 3 description: >- 视频输入数组 - 参考生视频：可选，公开建议最多 3 个；`duration` 大于 10 秒时最多 1 个 - 视频编辑：必填且仅支持 1 个，时长不超过 15 秒 - 视频扩展：必填且仅支持 1 个，时长不超过 30 秒 - 视频超分辨率：必填且仅支持 1 个，时长不超过 15 秒，尺寸仅支持 `640×360`、`1280×720`、`1920×1080` 及对应竖屏尺寸 - 文生视频和图生视频：不支持视频输入 每段参考视频的时长不得超过 `10` 秒。 example: - https://example.com/reference.mp4 quality: type: string description: >- 视频分辨率 **可选值：** - `360p`：横屏 640×360 / 竖屏 360×640 - `720p`：横屏 1280×720 / 竖屏 720×1280 - `1080p`：横屏 1920×1080 / 竖屏 1080×1920 - `4k`：横屏 3840×2160 / 竖屏 2160×3840 - `auto`：仅视频编辑和视频扩展支持，表示跟随输入视频分辨率 **默认值：** - 文生视频、图生视频、参考生视频：`720p` - 视频编辑、视频扩展：`auto` - 视频超分辨率：必填，为目标分辨率，须高于输入视频分辨率（360p 可选 `720p`、`1080p`；720p 可选 `1080p`、`4k`；1080p 可选 `4k`） **计费说明：** 文生、图生、参考生、编辑和扩展按输入 token、视频输出 token 及其他输出 token（含思考）分别计费。视频超分辨率仅收取视频输出 token 费用，不收取输入或思考 token 费用。提交时的费用为预估，最终按实际用量结算。 enum: - 360p - 720p - 1080p - 4k - auto example: 720p duration: description: |- 视频时长 - 文生视频、参考生视频：`3`～`15` 秒整数，默认 `3` - 图生视频：传 1 张首帧时 `3`～`15` 秒，传 2 张首尾帧时 `3`～`10` 秒，默认 `3` - 视频编辑、视频超分辨率：仅允许 `auto`，默认 `auto`，输出时长跟随输入视频 - 视频扩展：`3`～`10` 秒整数，默认 `3`，表示追加秒数 oneOf: - type: integer minimum: 3 maximum: 15 - type: string enum: - auto example: 3 aspect_ratio: type: string description: |- 视频宽高比，默认为 `auto` **取值说明：** - `16:9`：横向画面 - `9:16`：竖向画面 - `auto`：由模型根据提示词和输入素材决定画面比例，此为默认值 视频编辑、视频扩展和视频超分辨率仅允许 `auto`，输出比例跟随输入视频。 enum: - '16:9' - '9:16' - auto default: auto example: auto seed: type: integer description: |- 随机种子，默认随机 **说明：** - 取值范围：`0` ~ `4294967295` - 固定 seed 可在调试 prompt 时降低参数变化的干扰，提升结果可复现性 minimum: 0 maximum: 4294967295 example: 42 callback_url: type: string description: |- 任务完成后的HTTPS回调地址 **回调时机：** - 任务完成（completed）、失败（failed）或取消（cancelled）时触发 - 在计费确认完成后发送 **安全限制：** - 仅支持HTTPS协议 - 禁止回调到内网IP地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x等） - URL长度不超过`2048`字符 **回调机制：** - 超时时间：`10`秒 - 失败后最多重试`3`次（会分别在失败的`1`秒/`2`秒/`4`秒后进行重试） - 回调响应体格式与任务查询接口返回的格式一致 - 回调地址若返回2xx状态码视为成功，其他状态码会触发重试 format: uri example: https://your-domain.com/webhooks/video-task-completed allOf: - if: properties: model: const: gemini-omni-1.2-flash-text-to-video required: - model then: properties: duration: type: integer default: 3 minimum: 3 maximum: 15 quality: enum: - 360p - 720p - 1080p - 4k default: 720p prompt: minLength: 1 pattern: \S not: anyOf: - required: - image_urls - required: - video_urls required: - prompt - if: properties: model: const: gemini-omni-1.2-flash-image-to-video required: - model then: required: - prompt - image_urls properties: image_urls: maxItems: 2 duration: type: integer default: 3 minimum: 3 maximum: 15 quality: enum: - 360p - 720p - 1080p - 4k default: 720p prompt: minLength: 1 pattern: \S not: anyOf: - required: - video_urls allOf: - if: properties: image_urls: minItems: 2 required: - image_urls then: properties: duration: maximum: 10 - if: properties: model: const: gemini-omni-1.2-flash-reference-to-video required: - model then: required: - prompt - image_urls properties: video_urls: maxItems: 3 duration: type: integer default: 3 minimum: 3 maximum: 15 quality: enum: - 360p - 720p - 1080p - 4k default: 720p prompt: minLength: 1 pattern: \S allOf: - if: properties: duration: type: integer minimum: 11 required: - duration then: properties: video_urls: maxItems: 1 - if: properties: model: const: gemini-omni-1.2-flash-video-edit required: - model then: required: - prompt - video_urls properties: video_urls: maxItems: 1 image_urls: maxItems: 10 duration: type: string enum: - auto default: auto aspect_ratio: enum: - auto quality: enum: - 360p - 720p - 1080p - 4k - auto default: auto prompt: minLength: 1 pattern: \S - if: properties: model: const: gemini-omni-1.2-flash-video-extend required: - model then: required: - prompt - video_urls properties: video_urls: maxItems: 1 image_urls: maxItems: 10 duration: type: integer default: 3 minimum: 3 maximum: 10 aspect_ratio: enum: - auto quality: enum: - 360p - 720p - 1080p - 4k - auto default: auto prompt: minLength: 1 pattern: \S - if: properties: model: const: gemini-omni-1.2-flash-video-upscale required: - model then: required: - video_urls - quality properties: video_urls: maxItems: 1 quality: enum: - 720p - 1080p - 4k duration: type: string enum: - auto default: auto aspect_ratio: enum: - auto default: auto not: required: - image_urls VideoGenerationResponse: type: object properties: created: type: integer description: 任务创建时间戳 example: 1757169743 id: type: string description: 任务ID example: task-unified-1757169743-7cvnl5zw model: type: string description: 实际使用的模型名称 example: gemini-omni-1.2-flash-text-to-video object: type: string enum: - video.generation.task description: 任务的具体类型 progress: type: integer description: 任务进度百分比 (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: 任务状态。创建接口恒返回 `processing`（内部 `pending` 状态对客户端统一投影为 `processing`） enum: - pending - processing - completed - failed example: processing task_info: $ref: '#/components/schemas/VideoTaskInfo' description: 视频任务详细信息 type: type: string enum: - text - image - audio - video description: 任务的输出类型 example: video usage: $ref: '#/components/schemas/Usage' description: 使用量和计费信息 ErrorResponse: type: object properties: error: type: object properties: code: type: string description: 错误代码标识符 message: type: string description: 错误描述信息 type: type: string description: 错误类型 VideoTaskInfo: type: object properties: can_cancel: type: boolean description: 任务是否可以取消 example: false estimated_time: type: integer description: 预估完成时间（秒） minimum: 0 example: 60 video_duration: type: integer description: |- 输出视频时长（秒） - 文生视频、图生视频、参考生视频：等于请求中的 `duration` - 视频编辑：`duration` 默认并仅允许 `auto`，输出跟随输入视频，此处回显系统探测到的输入视频时长 - 视频扩展：为输出总时长，即输入视频时长加请求中的追加时长 `duration` - 视频超分辨率：与输入视频时长相同，此处回显系统探测到的输入视频时长 example: 3 Usage: type: object description: 使用量和计费信息 properties: billing_rule: type: string description: 计费规则 enum: - per_call - per_token - per_second example: per_token credits_reserved: type: number description: 预估消耗积分数 minimum: 0 example: 102.34 user_group: type: string description: 用户所属计费分组 example: default securitySchemes: bearerAuth: type: http scheme: bearer description: |- ##所有接口均需要使用Bearer Token进行认证## **获取 API Key ：** 访问 [API Key 管理页面](https://evolink.ai/dashboard/keys) 获取您的 API Key **使用时在请求头中添加：** ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.