生成演说任务

openapi: 3.0.1
info:
  title: ''
  description: "本页接口说明详见下方接口定义；参数取值与返回以本平台实测为准。"
  version: 1.0.0
paths:
  /higgsfield/speech:
    post:
      summary: 生成演说任务
      deprecated: false
      description: "HIGGSFIELD.3 · 人物说话类演说视频生成"
      tags:
        - 视频模型/Higgsfield
      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
              required:
                - avatar_preset_id
                - prompt
                - width
                - height
                - image
              properties:
                avatar_preset_id:
                  type: string
                  description: "演说模板 ID，可通过模板接口获取"
                prompt:
                  type: string
                  description: "生成用提示词"
                width:
                  type: integer
                  description: "输出视频宽度（像素）"
                height:
                  type: integer
                  description: "输出视频高度（像素）"
                image:
                  type: array
                  description: "形象头像，支持公网 URL 与 base64"
                  items:
                    type: string
                audio:
                  type: string
                  description: "语音文件地址（wav / mp3），时长不超过 13s，与 speak 二选一"
                speak:
                  type: object
                  description: "文本转语音配置，与 audio 二选一"
                  properties:
                    voice_id:
                      type: string
                      description: "人声音色 ID，可通过模板接口获取"
                    sound_id:
                      type: string
                      description: "环境声音 ID，可通过模板接口获取"
                    text:
                      type: string
                      description: "待转语音的文本内容"
                  required:
                    - voice_id
                    - text
              oneOf:
                - type: string
                - type: string
            examples: {}
      responses:
        '200':
          description: "该字段的取值与含义以本平台实际返回为准。"
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: "提交任务时平台下发的标识，后续查状态时带上"
              example:
                id: 9c1e0a2b-7d44-4f10-9a53-2b1c8e6d0f11
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []