MiniMax Voice Design · Référence de l’API
Décrivez une voix virtuelle, lisez son aperçu et réutilisez-la pour la synthèse text-to-speech.
Envoyez une requête JSON à POST /v1/wand/minimax-tts/sync_design avec une clé API APIMaster dans l'en-tête Authorization: Bearer. Voice Design crée une voix virtuelle à partir d'une description textuelle.
| Champ | Type | Description |
|---|---|---|
model |
string | Obligatoire. Utilisez minimax-voice-design. |
prompt |
string | Obligatoire. Décrivez la voix, la livraison, l'émotion et l'utilisation prévue. |
preview_text |
string | Obligatoire. Texte d’aperçu de 500 caractères maximum. |
voice_id |
string | ID vocal personnalisé en option. Un ID est généré si omis. |
output_format |
string | hex (par défaut) ou url. Les URLs d’aperçu sont valides pendant 24 heures. |
aigc_watermark |
boolean | Ajouter un filigrane audio. Valeur par défaut : false. |
curl -X POST "https://apimaster.ai/v1/wand/minimax-tts/sync_design" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"minimax-voice-design","prompt":"A warm and clear narrator at a natural pace","preview_text":"Welcome to the program.","output_format":"url"}'
Vérifiez base_resp.status_code=0 et utilisez base_resp.status_msg pour diagnostiquer les erreurs. Lire l'aperçu dans trial_audio en tant qu'audio décodé hexadé ou URL. Conservez request_id ou trace_id si une demande échoue. La réponse peut inclure usage.total_token.
Avec le même compte, utilisez le voice_id renvoyé tel quel dans voice_setting.voice_id pour MiniMax Speech. La prévisualisation et la synthèse ultérieure sont dosées séparément. La première synthèse complète peut inclure une redevance vocale. Une voix temporaire non utilisée expire après sept jours. Voir le Voice Design model card pour le prix actuel APIMaster.
