MiniMax Speech 2.8 HD / Turbo · API 레퍼런스
텍스트를 오디오로 변환하고, 음성과 형식을 선택하고, 버퍼링된 SSE 응답을 읽습니다.
보내기 JSON 요청하기 POST /v1/wand/minimax-tts/sync_tts 으로 APIMaster API 키 Authorization: Bearer 헤더. model을 minimax-speech-2.8-hd 또는 minimax-speech-2.8-turbo로 설정합니다.
| 필드 | 유형 | 설명 |
|---|---|---|
text |
string | 필수, 10,000 문자보다 적습니다. 단락의 경우 줄 바꿈, x초 동안 <#x#>, 발음의 경우 괄호로 묶은 핀인 또는 IPA를 사용합니다. 이 모델은 (laughs)와 같은 신호를 지원합니다. |
voice_setting |
object | 필수입니다. voice_id를 시스템 음성으로 설정하거나 음성 디자인 또는 음성 복제로 반환되는 전체 참조로 설정합니다. 음성을 혼합할 때는 이 ID를 비워두고 timbre_weights를 설정하십시오. |
voice_setting.speed, voice_setting.vol, voice_setting.pitch |
number | 속도 0.5–2 (기본 1). 보다 큰 음량 0 그리고 At Most 10 (기본) 1). 정수 피치 −12 12 (기본 0). |
voice_setting.emotion |
string | happy, sad, angry, fearful, disgusted, surprised, calm, 또는 fluent. 모델을 선택할 수 있도록 합니다. |
voice_setting.text_normalization, voice_setting.latex_read |
boolean | 둘 다 기본값은 false입니다. LaTeX 읽기를 위해 $$로 방정식을 래핑합니다. |
audio_setting.sample_rate |
integer | 8000, 16000, 22050, 24000, 32000 (과태), 또는 44100 Hz. |
audio_setting.bitrate |
integer | MP3 전용. 32000, 64000, 128000 (과태), 또는 256000 bps. |
audio_setting.format |
string | mp3 (기본값), pcm, flac, wav, pcmu_raw, pcmu_wav, 또는 opus. |
audio_setting.channel |
integer | 1 (기본값) 또는 2. |
pronunciation_dict.tone |
string[] | original/replacement 형식의 항목입니다. 교체는 텍스트, 병음, IPA 또는 일본어 kana를 사용할 수 있습니다. |
timbre_weights |
object[] | 1에서 100에 voice_id와 weight를 가진 4개까지 입장. |
language_boost |
string | 선택적인 언어 향상. 지원되는 언어인 auto를 사용하거나 생략합니다. |
voice_modify.pitch, voice_modify.intensity, voice_modify.timbre |
integer | −100 으로 100. |
voice_modify.sound_effects |
string | spacious_echo, auditorium_echo, lofi_telephone, 또는 robotic입니다. 비 스트리밍의 경우 이러한 효과는 MP3, WAV 및 FLAC에서 작동합니다. SSE를 위해, MP3를 사용하십시오. |
subtitle_enable, subtitle_type |
boolean, string | 자막은 기본적으로 꺼져 있습니다. 형식은 sentence(기본값) 또는 word입니다. |
output_format |
string | hex (기본값) 또는 url 비 스트리밍 요청에 대해. 미리 듣기 URLs는 24시간 동안 유효합니다. |
aigc_watermark, stream |
boolean | 둘 다 기본값은 false입니다. SSE는 생성 및 청구가 완료 될 때까지 버퍼링되고 16 진수 오디오를 전송합니다. |
language_boost 수락 Chinese, Chinese,Yue, English, Arabic, Russian, Spanish, French, Portuguese, German, Turkish, Dutch, Ukrainian, Vietnamese, Indonesian, Japanese, Italian, Korean, Thai, Polish, Romanian, Greek, Czech, Finnish, Hindi, Bulgarian, Danish, Hebrew, Malay, Persian, Slovak, Swedish, Croatian, Filipino, Hungarian, Norwegian, Slovenian, Catalan, Nynorsk, Tamil, 그리고 Afrikaans.
시스템 음성에는 English_Graceful_Lady, English_Trustworthy_Man, male-qn-qingse, male-qn-jingying, female-shaonv 및 female-yujie가 포함됩니다. 동일한 계정에서 Voice Design 또는 Voice Clone에서 반환된 사용자 지정 음성을 사용합니다.
curl -X POST "https://apimaster.ai/v1/wand/minimax-tts/sync_tts" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"minimax-speech-2.8-hd","text":"Welcome to the program.","voice_setting":{"voice_id":"English_Graceful_Lady"},"output_format":"url"}'
비 스트리밍 응답에서 base_resp.status_code가 0이고 data.status가 2인지 확인하십시오. data.audio에는 16진수로 인코딩된 오디오 또는 URL가 포함되어 있으며 data.subtitle_file에는 JSON 자막 파일이 포함될 수 있습니다. extra_info에는 밀리초 단위의 길이, 샘플 레이트, 크기, 형식 및 usage_characters가 포함될 수 있습니다. 실패 진단에 도움이 필요하면 trace_id 또는 request_id를 저장하십시오.
SSE의 경우 data.status=1가 세그먼트이고 2가 완료되고 [DONE]가 잠재적으로 완료됩니다. 16 진수 세그먼트를 순서대로 가입하고 바이트로 디코딩하십시오. 자막에는 문자 오프셋, 시간 오프셋(밀리초 단위) 및 timestamped_words가 포함될 수 있습니다. 누적 프레임을 합산하는 대신 누적 usage.total_tokens 또는 usage.total_token를 한 번 사용하십시오.
자세히 보기 HD 비디오 그리고 터보 현재를 위한 모형 카드 APIMaster 가격. 사용자 지정 음성을 갖는 초기 합성은 또한 음성 요금을 포함할 수 있다.
