众扬汇 AI 开放平台 API 文档

音色快速复刻

OpenAPI Specification

yaml
openapi: 3.0.1
info:
  title: ''
  description: "本页接口说明详见下方接口定义;参数取值与返回以本平台实测为准。"
  version: 1.0.0
paths:
  /minimax/v1/voice_clone:
    post:
      summary: 音色快速复刻
      deprecated: false
      description: "使用本接口进行音色快速复刻;复刻得到的音色若 7 天内未正式调用,系统将删除该音色。上游文档外链已移除,参数与返回以本平台实测为准。"
      tags:
        - 音频接口/MINIMAX 语音合成
      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:
                file_id:
                  type: integer
                voice_id:
                  type: string
                clone_prompt:
                  type: object
                  properties:
                    prompt_audio:
                      type: integer
                    prompt_text:
                      type: string
                  required:
                    - prompt_audio
                    - prompt_text
                text:
                  type: string
                model:
                  type: string
                need_noise_reduction:
                  type: boolean
                need_volume_normalization:
                  type: boolean
                aigc_watermark:
                  type: boolean
              required:
                - file_id
                - voice_id
            example:
              file_id: 123456789
              voice_id: <voice_id>
              clone_prompt:
                prompt_audio: 987654321
                prompt_text: This voice sounds natural and pleasant.
              text: >-
                A gentle breeze sweeps across the soft grass(breath), carrying
                the fresh scent along with the songs of birds.
              model: speech-2.8-hd
              need_noise_reduction: false
              need_volume_normalization: false
              aigc_watermark: false
      responses:
        '200':
          description: "该字段的取值与含义以本平台实际返回为准。"
          content:
            application/json:
              schema:
                type: object
                properties:
                  file:
                    type: object
                    properties:
                      file_id:
                        type: integer
                        description: "文件唯一标识"
                      bytes:
                        type: integer
                        description: "文件大小,单位字节"
                      created_at:
                        type: integer
                        description: "文件创建时间,Unix 时间戳,单位秒"
                      filename:
                        type: string
                        description: "文件名"
                      purpose:
                        type: string
                        description: "文件用途"
                  base_resp:
                    type: object
                    properties:
                      status_code:
                        type: integer
                        description: "状态码及含义:0 请求成功、1002 触发限流(请稍后重试)、1004 账号鉴权失败(请检查 API Key)、1008 账号余额不足、1026 图片描述涉及敏感内容、2013 传入参数异常(请检查入参)、2049 无效的 API Key。"
                      status_msg:
                        type: string
                        description: "本次任务的状态详情"
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []

使用提示:本页接口的 Base URL 为 https://api.allyang.cn,请求头需携带 Authorization: Bearer <令牌>(令牌在控制台「令牌管理」中创建)。示例中的任务 ID、时间戳与文件地址均为示意值,实际以平台返回为准。

模型名请在「模型广场」复制后填入,不要手输;计费、限流与在售清单以平台实测为准(部分数值待补)。