Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
/v1/voice_clone 接口保持一致，由 GregAPI 转发，无需自行签名。
export BASE_URL="https://api.gregapi.com"
export TOKEN="oh-xxxxxxxxxxxxxxxx"
Authorization: Bearer <TOKEN>
Content-Type: application/json
| 操作 | 方法 | 端点 |
|---|---|---|
| 音色快速复刻 | POST | /minimaxi/v1/voice_clone |
application/json。适用场景：IP 复刻、音色克隆等需要快速复刻某一音色的场景。
file_idcurl -X POST "https://api.gregapi.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 为原始文件名。
prompt_audio 的 file_idcurl -X POST "https://api.gregapi.com/minimaxi/v1/files/upload" \
-H "Authorization: Bearer $TOKEN" \
-F "purpose=prompt_audio" \
-F "file=@/path/to/short-sample.mp3"
/v1/voice_clone）| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
file_id | string / integer | 是 | 需要复刻音色的音频文件 file_id，通过 /minimaxi/v1/files/upload 获取 |
voice_id | string | 是 | 目标克隆音色的 voice_id，需满足官方命名规范 |
clone_prompt.prompt_audio | string | 否 | 示例音频的 file_id（通过 purpose=prompt_audio 上传获得） |
clone_prompt.prompt_text | string | 否 | 示例音频对应文本 |
text | string | 否 | 复刻试听文本（官方限制 ≤ 1000 字符） |
model | string | 条件必填 | 传入 text 时必填，试听所用语音模型，如 speech-2.8-hd、speech-2.8-turbo |
language_boost | string | 否 | 小语种/方言增强，如 Chinese、English、auto 等 |
need_noise_reduction | boolean | 否 | 是否开启降噪 |
need_volume_normalization | boolean | 否 | 是否开启音量归一化 |
aigc_watermark | boolean | 否 | 是否在试听音频末尾添加 AIGC 水印节奏 |
| 字段 | 说明 |
|---|---|
input_sensitive | 可选，输入音频命中风控时返回，包含 type 等信息 |
demo_audio | 若传入 text 与 model，返回试听音频链接 |
base_resp.status_code | 状态码，0 为成功 |
base_resp.status_msg | 状态描述 |
curl -X POST "https://api.gregapi.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
}'