Skip to content

音色快速复刻(Voice Cloning) ​

与 MiniMax /v1/voice_clone 保持一致的官方接口

概述

  • 路径:POST /minimaxi/v1/voice_clone
  • 媒介类型:application/json
  • 适用场景:IP 复刻、音色克隆等需要快速复刻某一音色的场景。

快速开始:三步完成音色复刻 ​

  1. 上传待复刻音频,获取 file_id
bash
curl -X POST "https://aiapi.fhddos.com/minimaxi/v1/files/upload" \
  -H "Authorization: Bearer $TOKEN" \
  -F "purpose=voice_clone" \
  -F "file=@/path/to/audio.mp3"

响应体中的:

  • file.file_id:后续传给 POST /minimaxi/v1/voice_clone
  • file.filename:原始文件名
  1. (可选)上传示例音频,获取 prompt_audio 的 file_id
bash
curl -X POST "https://aiapi.fhddos.com/minimaxi/v1/files/upload" \
  -H "Authorization: Bearer $TOKEN" \
  -F "purpose=prompt_audio" \
  -F "file=@/path/to/short-sample.mp3"
  1. 调用音色快速复刻接口,完成音色克隆并获取试听音频

请求字段(对齐 MiniMax 官方 /v1/voice_clone)

  • file_id:必填,需要复刻音色的音频文件 file_id,通过 POST /minimaxi/v1/files/upload 获取
  • voice_id:必填,目标克隆音色的 voice_id,需满足官方命名规范
  • clone_prompt:可选,示例音频与文本,用于增强相似度和稳定性
    • prompt_audio:示例音频的 file_id(通过 purpose=prompt_audio 上传获得)
    • prompt_text:示例音频对应文本
  • text:可选,复刻试听文本(官方限制 ≤ 1000 字符)
  • model:当传入 text 时必填,试听所用语音模型(如 speech-2.8-hd、speech-2.8-turbo 等)
  • language_boost:可选,小语种/方言增强,支持 Chinese、English、...、auto 等枚举
  • need_noise_reduction:可选,是否开启降噪
  • need_volume_normalization:可选,是否开启音量归一化
  • aigc_watermark:可选,是否在试听音频末尾添加 AIGC 水印节奏

返回字段

  • input_sensitive:可选,输入音频命中风控时返回,包含 type 等信息
  • demo_audio:若传入 text 与 model,则返回试听音频链接
  • base_resp:基础返回信息
    • status_code:状态码(0 为成功)
    • status_msg:状态描述

示例:带试听音频返回

bash
curl -X POST "https://aiapi.fhddos.com/minimaxi/v1/voice_clone" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": 1234567890,
    "voice_id": "MiniMax001",
    "text": "近年来,人工智能在国内迎来高速发展期...",
    "model": "speech-2.8-hd",
    "need_noise_reduction": true,
    "need_volume_normalization": true
  }'

OpenAPI ​

yaml
openapi: 3.0.3
info:
  title: Fhddos Core API
  version: '1.0'
  description: >-
    Core OpenAI-compatible and model-family endpoints used by the Fhddos user
    docs.
servers:
  - url: https://aiapi.fhddos.com
security:
  - BearerAuth: []
paths:
  /minimaxi/v1/voice_clone:
    post:
      tags:
        - MiniMaxi
      summary: MiniMaxi voice clone
      requestBody:
        $ref: '#/components/requestBodies/JsonObject'
      responses:
        '200':
          $ref: '#/components/responses/JsonObject'
components:
  requestBodies:
    JsonObject:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GenericObject'
  responses:
    JsonObject:
      description: OK
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GenericObject'
  schemas:
    GenericObject:
      type: object
      additionalProperties: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Authorization: Bearer <token>'

Fhddos AI 用户文档