APIMaster.ai

MiniMax Voice Design — 完整引數與計費

MiniMax Voice Design 的音色設計介面、試聽與語音合成用法。

MiniMax Voice Design

使用 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_design,JSON、Bearer 鑑權。自然語言生成虛擬音色,不需要參考音訊;不是語音復刻介面。

引數 型別 必填 說明
model string 是 minimax-voice-design
prompt string 是 音色描述,可描述年齡、性別、聲線、情緒及應用場景
preview_text string 是 試聽文字,最多 500 字元,由平臺預設 TTS 合成;不能誤寫成 text
voice_id string 否 自定義音色 ID;省略時自動生成
output_format string 否 hex(預設)/url;試聽 URL 有效期 24 小時
aigc_watermark boolean 否 音訊末尾標識,預設 false
{"model":"minimax-voice-design","prompt":"温和清晰的成年虚拟讲解员,语速自然","preview_text":"欢迎收听今天的节目。","output_format":"url"}

響應含 voice_id、trial_audio、base_resp.status_code/status_msg、usage.total_token。trial_audio 為 hex 或 URL;狀態碼 0 才算成功,HTTP 200 本身不能作為依據。用 voice_id 在後續 TTS 的 voice_setting.voice_id 指定此音色。

建立時的試聽可能產生語音用量。首次正式合成可能另收音色費,後續使用按正文語音用量計費。7 天內未正式使用的臨時音色會被刪除。

建立後可播放 trial_audio 試聽,在後續 TTS 請求中使用返回的完整音色引用。失敗時請保留 request_id 或 trace_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。不能填寫其他賬戶的引用。建立完成後,請使用響應中的完整音色引用。

價格

APIMaster 當前售價請檢視模型卡 minimax-voice-design。