生成数字人视频

openapi: 3.0.1
info:
  title: ''
  description: "本页接口说明详见下方接口定义；参数取值与返回以本平台实测为准。"
  version: 1.0.0
paths:
  /avatar/generation:
    post:
      summary: 生成数字人视频
      deprecated: false
      description: "上传图片或视频，并配合音频或文本，生成对应的数字人视频。注意：用于克隆的音频时长需 20s 以上，图片必须包含人脸。"
      tags:
        - 废弃、未开放/数字人
        - 数字人/官方 API
      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:
              $schema: http://json-schema.org/draft-07/schema#
              title: GenAvatarVideo Request
              description: "生成数字人视频的请求参数"
              type: object
              properties:
                audio_url:
                  type: string
                  description: "直接使用音频文件的地址"
                  format: uri
                create_voice:
                  type: object
                  description: "先用音频创建音色，再生成数字人"
                  properties:
                    audio_url:
                      type: string
                      description: "音频文件地址"
                      format: uri
                    language:
                      type: string
                      description: "语言代码，如 en、zh 等"
                      examples:
                        - en
                        - zh
                    text:
                      type: string
                      description: "待转语音的文本内容"
                  required:
                    - audio_url
                    - language
                    - text
                  additionalProperties: false
                use_voice:
                  type: object
                  description: "使用已有音色生成数字人"
                  properties:
                    voice_engine_id:
                      type: string
                      description: "语音引擎 ID"
                    audio_id:
                      type: string
                      description: "音频 ID"
                    language:
                      type: string
                      description: "语言代码，如 en、zh 等"
                      examples:
                        - en
                        - zh
                    text:
                      type: string
                      description: "待转语音的文本内容"
                  required:
                    - voice_engine_id
                    - audio_id
                    - language
                    - text
                  additionalProperties: false
                avatar_url:
                  type: string
                  description: "数字人形象图片或视频的地址"
                  format: uri
                no_watermark:
                  type: boolean
                  description: "是否去除水印"
                  default: false
              required:
                - avatar_url
              oneOf:
                - type: string
                - type: string
                - type: string
              additionalProperties: false
              examples:
                - audio_url: https://example.com/audio.mp3
                  avatar_url: https://example.com/avatar.jpg
                  no_watermark: true
                - create_voice:
                    audio_url: https://example.com/voice.mp3
                    language: en
                    text: Hello, world!
                  avatar_url: https://example.com/avatar.jpg
                - use_voice:
                    voice_engine_id: nina
                    audio_id: 9f2c1a4b7d0e5a83
                    language: en
                    text: Hello, world!
                  avatar_url: https://example.com/avatar.mp4
            examples: {}
      responses:
        '200':
          description: "该字段的取值与含义以本平台实际返回为准。"
          content:
            application/json:
              schema:
                type: string
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []