> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiid.edu.kg/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建图生视频(Vidu)

> 该系列支持OpenAI视频生成格式（详见链接 [视频生成Sora兼容格式](/api-reference/cn/视频生成sora兼容格式/创建视频)）。

Vidu 官方视频生成接口，公开路径遵循 Vidu 官方协议。

当前公开模型：`viduq3-turbo`。支持文生视频、图生视频、首尾帧生视频、参考生视频。同一模型也支持通过 `/v1/videos` Sora 兼容格式接入，常用 `mode` 为 `t2v`、`i2v`、`i2v_first_last`、`reference_images`。

补充 Vidu 官方视频生成格式的公开请求骨架、任务查询结构和推荐验证模板，公开路径保持 Vidu 官方端点格式。

支持模型：
viduq3-turbo

统一请求字段：
- `model` (string, 必填): Vidu 对外模型名，当前公开 `viduq3-turbo`。
- `prompt` (string, 可选): 视频生成提示词；文生视频必填，图生/首尾帧/参考生视频按业务需要传。
- `images` (array[string], 可选): 图片输入。图生视频 1 张，首尾帧 2 张，参考生视频 1~7 张。
- `videos` (array[string], 可选): 参考生视频可选视频主体输入，按 Vidu 官方模型能力使用。
- `subjects` (array[object], 可选): 参考生视频主体库格式输入，可包含主体名称、图片、视频或音色等字段。
- `duration` (integer, 可选): 视频时长，单位秒。`viduq3-turbo` 常用 5 秒，可按官方范围设置。
- `resolution` (string, 可选): 输出分辨率，常见值 `540p`、`720p`、`1080p`。
- `aspect_ratio` (string, 可选): 输出宽高比，文生/参考生视频常用，如 `16:9`、`9:16`、`1:1`。
- `seed` (integer, 可选): 随机种子。
- `movement_amplitude` (string, 可选): 运动幅度，常见值 `auto`、`small`、`medium`、`large`。
- `audio` (boolean, 可选): 是否开启音视频直出。
- `off_peak` (boolean, 可选): 是否使用错峰生成。
- `watermark` (boolean, 可选): 是否添加水印。

常见模型/模式差异：
- `Vidu 文生视频`: 支持模型 viduq3-turbo；官方格式文生视频。
- `Vidu 图生视频`: 支持模型 viduq3-turbo；官方格式单图图生视频。
- `Vidu 首尾帧生视频`: 支持模型 viduq3-turbo；官方格式首尾帧双图生视频。
- `Vidu 参考生视频`: 支持模型 viduq3-turbo；官方格式多参考图生视频。



## OpenAPI

````yaml api-reference/cn/openapi.json POST /ent/v2/img2video
openapi: 3.0.0
info:
  title: 出海营 API 参考文档
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: OpenAI格式(Chat)
  - name: OpenAI格式(Responses)
  - name: 图片生成Gemini格式
  - name: 图片生成OpenAI DALL-E格式
  - name: 获取模型列表
  - name: 视频生成HappyHorse与Wan
  - name: 视频生成Kling格式
  - name: 视频生成Omni与Veo格式
  - name: 视频生成Seedance格式
  - name: 视频生成Sora兼容格式
  - name: 视频生成Vidu格式
  - name: 音乐生成任务格式
paths:
  /ent/v2/img2video:
    post:
      tags:
        - 视频生成Vidu格式
      summary: 创建图生视频(Vidu)
      description: >-
        该系列支持OpenAI视频生成格式（详见链接
        [视频生成Sora兼容格式](/api-reference/cn/视频生成sora兼容格式/创建视频)）。


        Vidu 官方视频生成接口，公开路径遵循 Vidu 官方协议。


        当前公开模型：`viduq3-turbo`。支持文生视频、图生视频、首尾帧生视频、参考生视频。同一模型也支持通过 `/v1/videos`
        Sora 兼容格式接入，常用 `mode` 为 `t2v`、`i2v`、`i2v_first_last`、`reference_images`。


        补充 Vidu 官方视频生成格式的公开请求骨架、任务查询结构和推荐验证模板，公开路径保持 Vidu 官方端点格式。


        支持模型：

        viduq3-turbo


        统一请求字段：

        - `model` (string, 必填): Vidu 对外模型名，当前公开 `viduq3-turbo`。

        - `prompt` (string, 可选): 视频生成提示词；文生视频必填，图生/首尾帧/参考生视频按业务需要传。

        - `images` (array[string], 可选): 图片输入。图生视频 1 张，首尾帧 2 张，参考生视频 1~7 张。

        - `videos` (array[string], 可选): 参考生视频可选视频主体输入，按 Vidu 官方模型能力使用。

        - `subjects` (array[object], 可选): 参考生视频主体库格式输入，可包含主体名称、图片、视频或音色等字段。

        - `duration` (integer, 可选): 视频时长，单位秒。`viduq3-turbo` 常用 5 秒，可按官方范围设置。

        - `resolution` (string, 可选): 输出分辨率，常见值 `540p`、`720p`、`1080p`。

        - `aspect_ratio` (string, 可选): 输出宽高比，文生/参考生视频常用，如 `16:9`、`9:16`、`1:1`。

        - `seed` (integer, 可选): 随机种子。

        - `movement_amplitude` (string, 可选): 运动幅度，常见值
        `auto`、`small`、`medium`、`large`。

        - `audio` (boolean, 可选): 是否开启音视频直出。

        - `off_peak` (boolean, 可选): 是否使用错峰生成。

        - `watermark` (boolean, 可选): 是否添加水印。


        常见模型/模式差异：

        - `Vidu 文生视频`: 支持模型 viduq3-turbo；官方格式文生视频。

        - `Vidu 图生视频`: 支持模型 viduq3-turbo；官方格式单图图生视频。

        - `Vidu 首尾帧生视频`: 支持模型 viduq3-turbo；官方格式首尾帧双图生视频。

        - `Vidu 参考生视频`: 支持模型 viduq3-turbo；官方格式多参考图生视频。
      operationId: createViduImageVideo
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - images
              properties:
                model:
                  type: string
                  enum:
                    - viduq3-turbo
                  example: viduq3-turbo
                  description: Vidu 对外模型名，当前公开 `viduq3-turbo`。
                prompt:
                  type: string
                  example: A cinematic product ad with smooth camera motion
                  description: 视频生成提示词；文生视频必填，图生/首尾帧/参考生视频按业务需要传。
                images:
                  type: array
                  items:
                    type: string
                    format: uri
                  example:
                    - https://example.com/input.jpg
                  minItems: 1
                  maxItems: 1
                  description: 图片输入。图生视频 1 张，首尾帧 2 张，参考生视频 1~7 张。
                videos:
                  type: array
                  items:
                    type: string
                    format: uri
                  description: 参考生视频可选视频主体输入，按 Vidu 官方模型能力使用。
                subjects:
                  type: array
                  items:
                    type: object
                    properties:
                      name:
                        type: string
                      images:
                        type: array
                        items:
                          type: string
                          format: uri
                      videos:
                        type: array
                        items:
                          type: string
                          format: uri
                      voice_id:
                        type: string
                      server_id:
                        type: string
                  description: 参考生视频主体库格式输入，可包含主体名称、图片、视频或音色等字段。
                auto_subjects:
                  type: boolean
                duration:
                  type: integer
                  example: 5
                  description: 视频时长，单位秒。`viduq3-turbo` 常用 5 秒，可按官方范围设置。
                resolution:
                  type: string
                  enum:
                    - 540p
                    - 720p
                    - 1080p
                  example: 720p
                  description: 输出分辨率，常见值 `540p`、`720p`、`1080p`。
                aspect_ratio:
                  type: string
                  enum:
                    - '16:9'
                    - '9:16'
                    - '4:3'
                    - '3:4'
                    - '1:1'
                  example: '16:9'
                  description: 输出宽高比，文生/参考生视频常用，如 `16:9`、`9:16`、`1:1`。
                seed:
                  type: integer
                  description: 随机种子。
                movement_amplitude:
                  type: string
                  enum:
                    - auto
                    - small
                    - medium
                    - large
                  example: auto
                  description: 运动幅度，常见值 `auto`、`small`、`medium`、`large`。
                audio:
                  type: boolean
                  description: 是否开启音视频直出。
                audio_type:
                  type: string
                  enum:
                    - all
                    - speech_only
                    - sound_effect_only
                voice_id:
                  type: string
                is_rec:
                  type: boolean
                bgm:
                  type: boolean
                payload:
                  type: string
                off_peak:
                  type: boolean
                  description: 是否使用错峰生成。
                watermark:
                  type: boolean
                  description: 是否添加水印。
                wm_position:
                  type: integer
                  enum:
                    - 1
                    - 2
                    - 3
                    - 4
                wm_url:
                  type: string
                  format: uri
                callback_url:
                  type: string
                  format: uri
            examples:
              vidu_native_t2v:
                summary: Vidu 文生视频
                value:
                  model: viduq3-turbo
                  prompt: A cinematic product ad with smooth camera motion
                  duration: 5
                  resolution: 720p
                  aspect_ratio: '16:9'
              vidu_native_i2v:
                summary: Vidu 图生视频
                value:
                  model: viduq3-turbo
                  images:
                    - https://example.com/product.jpg
                  prompt: The product rotates slowly under studio light
                  duration: 5
                  resolution: 720p
              vidu_native_start_end:
                summary: Vidu 首尾帧生视频
                value:
                  model: viduq3-turbo
                  images:
                    - https://example.com/start.jpg
                    - https://example.com/end.jpg
                  prompt: A smooth camera move from the first frame to the final frame
                  duration: 5
                  resolution: 720p
              vidu_native_reference:
                summary: Vidu 参考生视频
                value:
                  model: viduq3-turbo
                  images:
                    - https://example.com/ref-1.jpg
                    - https://example.com/ref-2.jpg
                    - https://example.com/ref-3.jpg
                  prompt: >-
                    Keep the same character and product style in a cinematic
                    shot
                  duration: 5
                  resolution: 720p
                  aspect_ratio: '16:9'
      responses:
        '200':
          description: 任务创建成功
          content:
            application/json:
              schema:
                type: object
                required:
                  - task_id
                  - state
                properties:
                  task_id:
                    type: string
                    description: 创建任务返回的任务 ID，用于查询任务。
                  state:
                    type: string
                    enum:
                      - created
                      - queueing
                      - processing
                      - success
                      - failed
                    description: >-
                      任务状态，常见值
                      `created`、`queueing`、`processing`、`success`、`failed`。
                  model:
                    type: string
                  prompt:
                    type: string
                  images:
                    type: array
                    items:
                      type: string
                  duration:
                    type: integer
                  resolution:
                    type: string
                  created_at:
                    type: string
                  creations:
                    type: string
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: 任务成功后的生成视频 URL。
                        cover_url:
                          type: string
                          description: 任务成功后的封面 URL。
                        watermarked_url:
                          type: string
                          description: 带水印视频 URL。
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        使用 Bearer Token 认证。
        格式: `Authorization: Bearer sk-xxxxxx`

````