Appearance
音色快速复刻(Voice Cloning)
与 MiniMax /v1/voice_clone 保持一致的官方接口
概述
- 路径:
POST /minimaxi/v1/voice_clone - 媒介类型:
application/json - 适用场景:IP 复刻、音色克隆等需要快速复刻某一音色的场景。
快速开始:三步完成音色复刻
- 上传待复刻音频,获取
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_clonefile.filename:原始文件名
- (可选)上传示例音频,获取
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"- 调用音色快速复刻接口,完成音色克隆并获取试听音频
请求字段(对齐 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>'