MiniMax Voice Design · Referencia de la API
Describir una voz virtual, reproducir su vista previa y reutilizarla para la síntesis text-to-speech.
Enviar una solicitud de JSON a POST /v1/wand/minimax-tts/sync_design con una clave de API APIMaster en el encabezado Authorization: Bearer. Voice Design crea una voz virtual a partir de una descripción de texto.
| Campo | Tipo | Descripción |
|---|---|---|
model |
string | Obligatorio. Utilice minimax-voice-design. |
prompt |
string | Obligatorio. Describa la voz, la entrega, la emoción y el uso previsto. |
preview_text |
string | Obligatorio. Texto de vista previa de hasta 500 caracteres. |
voice_id |
string | Identificación de voz personalizada opcional. Se genera un ID si se omite. |
output_format |
string | hex (por defecto) o url. Las URLs de vista previa caducan después de 24 horas. |
aigc_watermark |
boolean | Añada una marca de agua de audio. Valor predeterminado: 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"}'
Compruebe base_resp.status_code=0 y use base_resp.status_msg para diagnosticar errores. Reproduce la vista previa en trial_audio como audio hexadecodificado o URL. Mantenga request_id o trace_id si una solicitud falla. La respuesta puede incluir usage.total_token.
Con la misma cuenta, usa el voice_id de la respuesta sin modificarlo como voice_setting.voice_id en MiniMax Speech. La vista previa y la síntesis posterior se miden por separado. La primera síntesis completa puede incluir una cuota de voz. Una voz temporal no utilizada expira después de siete días. Consulte la tarjeta modelo Voice Design para obtener el precio actual de APIMaster.
