众扬汇 AI 开放平台 API 文档

多模态参考生视频

接口:POST /v2/videos/generations 归属:视频模型/sdols/统一格式 调用地址: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:
  /v2/videos/generations:
    post:
      summary: 多模态参考生视频
      description: "统一接口格式,支持多图、多视频、多音频参考。"
      tags:
        - 视频模型/sdols/统一格式
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
            default: Bearer {{YOUR_API_KEY}}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                  description: "必填。成片文案,中英文均可,建议控制在 500 字以内;字数过多容易分散信息,模型可能只抓重点、漏掉细节,导致画面缺元素。"
                model:
                  type: string
                  description: "型号名称,示例:doubao-seedance-2-0-fast-260128。"
                  enum:
                    - doubao-seedance-2-0-260128
                    - doubao-seedance-2-0-fast-260128
                    - doubao-seedance-2.0-mini
                duration:
                  type: integer
                  description: "生成视频的持续时间(单位秒),4-15s。"
                  enum:
                    - 5
                    - 10
                  default: 5
                watermark:
                  type: boolean
                  description: "是否加水印。水印打在视频右下角,注明“由人工智能生成”。"
                  default: false
                seed:
                  type: integer
                  description: "随机数种子,用于控制生成内容的随机性,取值须落在 [0, 2147483647]。不传时由算法随机生成;希望结果相对稳定可复用同一 seed 值。"
                resolution:
                  type: string
                  description: "视频分辨率。"
                  enum:
                    - 480p
                    - 720p
                    - 1080p
                  default: 480p
                ratio:
                  type: string
                  description: "成片宽高比,支持 21:9、16:9、4:3、1:1、3:4、9:16、9:21;adaptive 表示按上传图片的比例自动挑最合适的档。"
                  default: '16:9'
                generate_audio:
                  type: boolean
                images:
                  type: array
                  items:
                    type: string
                  description: "参考图,每项为直链或 asset://{素材id}。"
                videos:
                  type: array
                  items:
                    type: string
                  description: "参考视频,每项为直链或 asset://{素材id}。"
                audios:
                  type: array
                  items:
                    type: string
                  description: "参考音频。"
                tools:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                        description: "web_search:联网检索开关。"
                    required:
                      - type
              required:
                - prompt
                - model
                - duration
            example:
              prompt: dance
              model: doubao-seedance-1-0-lite-t2v-250428
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  task_id:
                    type: string
                required:
                  - task_id
              example:
                task_id: cgt-20250831141439-sqmgf
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []