MiniMax Voice Design · Referência da API
Descreva uma voz virtual, reproduza sua pré-visualização e reutilize-a para a síntese text-to-speech.
Envie um pedido JSON para POST /v1/wand/minimax-tts/sync_design com uma chave de API APIMaster no cabeçalho Authorization: Bearer. O Voice Design cria uma voz virtual a partir de uma descrição de texto.
| Campo | Tipo | Descrição |
|---|---|---|
model |
string | Obrigatório. Use minimax-voice-design. |
prompt |
string | Obrigatório. Descreva a voz, a entrega, a emoção e o uso pretendido. |
preview_text |
string | Obrigatório. Texto de áudio para prévia com até 500 caracteres. |
voice_id |
string | ID de voz personalizada opcional. Um ID é gerado se omitido. |
output_format |
string | hex (padrão) ou url. As URLs de prévia ficam disponíveis por 24 horas. |
aigc_watermark |
boolean | Adicione uma marca d'água de áudio. Valor padrão: 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"}'
Verifique base_resp.status_code=0 e use base_resp.status_msg para diagnosticar erros. Reproduza a pré-visualização em trial_audio como áudio decodificado por hex ou um URL. Mantenha request_id ou trace_id se um pedido falhar. A resposta pode incluir usage.total_token.
Na mesma conta, use o voice_id retornado sem alterações como voice_setting.voice_id no MiniMax Speech. A pré-visualização e a síntese subsequente são medidas separadamente. A primeira síntese completa pode incluir uma taxa de voz. Uma voz temporária não utilizada expira após sete dias. Veja o modelo Voice Design card para o preço atual APIMaster.
