MiniMax Voice Clone — 完整引數與計費
MiniMax Voice Clone 的音訊樣本要求、聲音復刻介面和試聽響應。
MiniMax Voice Clone
使用 APIMaster API Key:Authorization: Bearer $APIMASTER_API_KEY,請求型別為 application/json。本頁完整路徑中的 /v1 已包含在 https://apimaster.ai/v1 中,例如 /v1/wand/... 對應 https://apimaster.ai/v1/wand/...。
閘道器先預留額度,確認實際用量後只結算一次,多餘預留額度返還。餘額不足時請求會在提交前拒絕。網路中斷後請保留 request_id,避免盲目重發生成請求。
POST /v1/wand/minimax-tts/sync_clone,JSON、Bearer 鑑權。模型 minimax-voice-clone,生成可供後續 TTS 使用的 voice_id。只使用有權用於復刻的聲音樣本。
| 引數 | 型別 | 必填 | 說明 |
|---|---|---|---|
| model | string | 是 | minimax-voice-clone |
| audio_url | string | 條件 | 樣本音訊公網 URL;mp3/m4a/wav,建議 10 秒–5 分鐘,最多 20MB;與 audio_data 至少提供一種 |
| audio_data | string | 條件 | Base64 樣本音訊 |
| file_id | integer | 不支援 | APIMaster 不接受此欄位,請使用 audio_url 或 audio_data |
| tts_model | string | 否 | 試聽語音模型,例如 minimax-speech-2.8-hd;有試聽文字時同時指定 |
| voice_id | string | 否 | 不傳自動生成;自定義時長度 8–256,英文字母開頭,允許字母、數字、連字元、下劃線;結尾不可為連字元/下劃線 |
| text | string | 否 | 最多 1000 字元的試聽文字;提供時按 tts_model 合成試聽 |
| text_validation | string | 否 | 樣本預期轉寫,最多 200 字元;ASR 匹配不足時拒絕 |
| accuracy | number | 否 | 轉寫相似度閾值,0–1,預設 0.7 |
| output_format | string | 否 | hex(預設)/url,試聽 URL 有效期 24 小時 |
響應欄位:voice_id、input_sensitive、demo_audio、extra_info、base_resp、usage。demo_audio 只在提供 text 時返回;extra_info 也對應試聽,含 audio_length(毫秒)、audio_sample_rate(Hz)、audio_size(位元組)、bitrate、word_count、usage_characters。base_resp.status_code=0 為成功;status_msg 描述錯誤。usage.total_token 為計費 tokens,需相容實測中可能出現的 total_tokens。
音色建立時可按所選語音模型計費生成試聽。音色費在首次正式使用該音色合成時結算,具體費用以賬單為準。臨時音色 7 天內未正式使用會被刪除。
後續請求在語音合成的 voice_setting.voice_id 填入返回的完整引用;該音色只能由建立它的賬戶使用。
音色引用與賬戶隔離
可直接使用的系統音色為 English_Graceful_Lady、English_Trustworthy_Man、male-qn-qingse、male-qn-jingying、female-shaonv、female-yujie。自定義音色必須使用本賬戶透過音色設計或復刻介面返回的完整 thvoice_... 引用;該值可以直接放入 voice_setting.voice_id 或 timbre_weights[].voice_id。不能填寫其他賬戶的引用。建立完成後,請使用響應中的完整音色引用。
透過 audio_url 或 audio_data 提供樣本。公開閘道器不接受 file_id,也不提供檔案上傳介面。
價格
APIMaster 當前售價請檢視模型卡 minimax-voice-clone。
