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

# Wan 3.0 Video

> Wan 3.0 普通版，支持文生视频、首尾帧和多模态参考。



## OpenAPI

````yaml zh/openapi/videos/wan3-0-video.yaml POST /v1/videos/generate
openapi: 3.1.0
info:
  title: Wan 3.0 Video
  version: '1.0'
  description: Wan 3.0 普通版，支持文生视频、首尾帧和多模态参考。
servers:
  - url: https://openapi.imini.ai/imini/router
security:
  - ApiKeyAuth: []
paths:
  /v1/videos/generate:
    post:
      summary: Wan 3.0 Video
      description: >
        模型 ID 为 `wan3.0-video`，不是 `dashscope/wan3.0-video`。提交后通过视频任务查询接口轮询结果。


        支持仅提示词、单首帧、首尾帧，以及图片/视频/音频组合参考。首尾帧不能与普通参考素材混用，不支持单尾帧。音频参考须搭配图片或视频，本期不开放独立视频编辑或
        `edit_source`。无需传 `video_mode`。


        默认 720P、5 秒；按请求输出时长计费：480P 每秒80、720P 每秒160、1080P
        每秒280积分。参考视频输入时长不加价，音频开关不影响积分。


        输入视频每段1~15秒，合计最多15秒；输入视频与请求输出时长合计不能超过30秒，由上游校验。素材必须可公开访问。本模型不开放
        keep_original_sound、generate_bgm 或扩展参数。
      operationId: generateWan30Video
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
              properties:
                model:
                  type: string
                  enum:
                    - wan3.0-video
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 20000
                  description: 必填提示词。
                resolution:
                  type: string
                  enum:
                    - 480P
                    - 720P
                    - 1080P
                  default: 720P
                duration:
                  type: integer
                  minimum: 2
                  maximum: 30
                  default: 5
                  description: 请求输出时长（秒），不接受 -1。
                aspect_ratio:
                  type: string
                  enum:
                    - '16:9'
                    - '9:16'
                    - '1:1'
                    - '4:3'
                    - '3:4'
                  description: 可省略，由模型自动适配。
                generate_audio:
                  type: boolean
                  default: false
                  description: 是否生成音频，不影响积分。
                reference_images:
                  type: array
                  maxItems: 10
                  description: 最多10张普通参考图；帧控制仅允许1张首帧及可选1张尾帧。
                  items:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                        description: 公开 HTTP(S) 图片 URL 或 data:image/ Base64。
                      reference_type:
                        type:
                          - string
                          - 'null'
                        default: asset
                        description: >-
                          asset（默认）、first_frame、last_frame；省略、null、空串或未知字符串按asset处理。
                reference_videos:
                  type: array
                  maxItems: 5
                  items:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                        description: 公开 HTTP(S) 视频 URL，不支持Base64。
                      reference_type:
                        type:
                          - string
                          - 'null'
                        default: asset
                        description: 使用asset参考视频；省略、null、空串或未知字符串按asset处理。不支持edit_source。
                reference_audios:
                  type: array
                  maxItems: 5
                  description: 须搭配普通图片或视频参考。
                  items:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                        description: 公开 HTTP(S) 音频 URL，不支持Base64。
                      reference_type:
                        type:
                          - string
                          - 'null'
                        default: asset
                        description: asset；省略、null、空串或未知字符串按asset处理。
            examples:
              text:
                summary: 文生视频
                value:
                  model: wan3.0-video
                  prompt: A slow camera move across a garden in morning light.
                  resolution: 720P
                  duration: 5
              frames:
                summary: 首尾帧
                value:
                  model: wan3.0-video
                  prompt: Smoothly transition between the two scenes.
                  duration: 5
                  reference_images:
                    - url: https://example.com/first.png
                      reference_type: first_frame
                    - url: https://example.com/last.png
                      reference_type: last_frame
              mixed:
                summary: 图片、视频和音频组合参考（替换为可访问素材）
                value:
                  model: wan3.0-video
                  prompt: >-
                    Generate a garden scene using the supplied visual and sound
                    references.
                  resolution: 480P
                  duration: 5
                  generate_audio: true
                  reference_images:
                    - url: https://example.com/image.png
                      reference_type: asset
                  reference_videos:
                    - url: https://example.com/video.mp4
                      reference_type: asset
                  reference_audios:
                    - url: https://example.com/audio.mp3
                      reference_type: asset
      responses:
        '200':
          description: 任务已提交，请轮询查询结果。
          content:
            application/json:
              schema:
                type: object
                properties:
                  task_id:
                    type: string
                  model:
                    type: string
                    example: wan3.0-video
                  created_at:
                    type: string
                    description: ISO 8601 UTC
                  request_id:
                    type: string
        '400':
          description: 请求参数错误
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      status:
                        type: integer
                      request_id:
                        type: string
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        使用 Authorization: Bearer <YOUR_API_KEY>. [API
        Keys](https://imini.ai/zh/api-keys)

````