众扬汇 AI 开放平台 API 文档

图生视频

接口:POST /vidu/v2/img2video 归属:视频模型/vidu 调用地址:Base URL https://api.allyang.cn(OpenAI 兼容前缀 https://api.allyang.cn/v1)+ 上述路径 鉴权:请求头 Authorization: Bearer <你的令牌>;令牌在控制台「令牌管理」创建 说明:下方为本接口契约。路径、字段名与枚举取值与线上接口一致;叙述文字已按本平台口径重写。价格、并发与限流等数值以控制台及实际返回为准,未确认处标注「待补」。

OpenAPI Specification

yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /vidu/v2/img2video:
    post:
      summary: 图生视频
      description: "参数清单(附类型与是否必填):model(String,必填)可选 viduq2-pro、viduq2-turbo、viduq1、viduq1-classic、vidu2.0、vidu1.5;images(Array[String],必填)首帧图像,支持 Base64 或图片 URL,格式 png/jpeg/jpg/webp,单张宽高比需小于 1:4 或 4:1,体积不超过 50 MB;prompt(String,可选)视频文本描述,不超过 2000 字符;is_rec(Bool,可选)是否使用推荐提示词,true 由系统推荐(推荐词数量 1),false 使用自定义提示词,启用推荐每个任务额外消耗 10 积分;duration(Int,可选)时长随模型默认值:viduq2-pro、viduq2-turbo、viduq1、viduq1-classic 默认 5 秒、可选 1 至 8,vidu2.0 与 vidu1.5 默认 4 秒、可选 4 或 8;seed(Int,可选)随机种子,不传或传 0 时改用随机数;resolution(String,可选)分辨率:viduq2-pro 默认 720p、可选 540p/720p/1080p,viduq1 与 viduq1-classic 默认 1080p,vidu2.0 与 vidu1.5 在 4 秒时默认 360p、8 秒时默认 720p(均可选 360p/720p/1080p);movement_amplitude(String,可选)运动幅度,默认 auto,另可选 small、medium、large;bgm(Bool,可选)是否配背景音乐,默认 false,置 true 时由系统挑选合适音乐;payload(String,可选)透传参数,最大 1048576 字符;off_peak(Bool,可选)错峰模式,默认 false,置 true 为错峰生成(积分消耗较低,48 小时内出片);watermark(Bool,可选)是否加水印,默认不加;wm_position(Int,可选)水印位置 1 左上角、2 右上角、3 右下角、4 左下角,默认 3;wm_url(String,可选)自定义水印图片 URL,不传则用默认水印;meta_data(String,可选)元数据标识,JSON 字符串,可自定义。示例格式:{“Label”:“your_label”,“ContentProducer”:“yourcontentproducer”,“ContentPropagator”:“your_content_propagator”,“ProduceID”:“yourproductid”,“PropagateID”:“your_propagate_id”,“ReservedCode1”:“yourreservedcode1”,“ReservedCode2”:“your_reserved_code2”}"
      tags:
        - 视频模型/vidu
      parameters:
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: Authorization
          in: header
          description: ''
          required: false
          example: Bearer &#123;&#123;YOUR_API_KEY&#125;&#125;
          schema:
            type: string
            default: Bearer &#123;&#123;YOUR_API_KEY&#125;&#125;
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                images:
                  type: array
                  items:
                    type: string
                prompt:
                  type: string
                duration:
                  type: integer
                seed:
                  type: integer
                resolution:
                  type: string
                movement_amplitude:
                  type: string
                off_peak:
                  type: boolean
              required:
                - model
                - images
                - prompt
                - duration
                - seed
                - resolution
                - movement_amplitude
                - off_peak
            example:
              model: viduq2-pro
              images:
                - >-
                  https://api.allyang.cn/<外部地址已按合规要求移除>
              prompt: The astronaut waved and the camera moved up.
              duration: 5
              seed: 0
              resolution: 720p
              movement_amplitude: auto
              off_peak: false
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []