음성 합성(T2A V2)

MiniMax T2A V2로 음성을 동기 생성하며 JSON 및 SSE 스트리밍 응답을 지원합니다.

T2A V2는 음성, 말하기 속도, 음량, 억양, 오디오 인코딩, 발음 사전, 여러 음성 혼합, 음향 효과 및 자막 등의 설정을 지원하며 SSE 스트리밍으로 오디오 청크를 반환할 수 있습니다.

POST/v1/minimax/t2a_v2

음성을 동기 합성합니다. stream=false이면 전체 JSON을 반환하고 stream=true이면 SSE로 오디오 청크를 지속적으로 반환합니다.

API는 응답의 extra_info.usage_characters에 따라 실제 발음에 대한 과금 문자 수를 기록합니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

application/json

MiniMax T2A V2 음성 합성 요청입니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

model*string

MiniMax 음성 모델 ID입니다. 예를 들어 speech-2.8-hd, speech-2.8-turbo, speech-2.6-hd, speech-2.6-turbo, speech-02-hd, speech-02-turbo, speech-01-hd 또는 speech-01-turbo입니다. 실제 사용 가능한 모델은 현재 API 키가 반환하는 모델 목록을 기준으로 합니다.

길이1 <= length

text*string

음성으로 합성할 텍스트입니다. <#x#> 정지 태그, 괄호로 감싼 병음 또는 음성 기호 및 일부 모델에서 지원하는 감탄사 태그를 지원합니다.

길이1 <= length <= 9999

stream?boolean

Server-Sent Events 스트리밍 출력 사용 여부입니다.

기본값false

stream_options?

스트리밍 전송 매개변수입니다. 예를 들어 마지막 청크에 이어 붙인 오디오를 포함할지 제어합니다.

voice_setting?

audio_setting?

pronunciation_dict?

timbre_weights?array<>

여러 음성의 혼합 가중치입니다. 최대 4개의 음성을 혼합하며 시스템은 상대 가중치에 따라 비율을 배분합니다.

항목items <= 4

language_boost?string|null

언어 강화입니다. 예를 들어 Chinese, English 또는 auto입니다.

기본값null

voice_modify?

subtitle_enable?boolean

자막 생성 여부입니다.

기본값false

subtitle_type?string

자막 타임스탬프의 세분화 수준입니다.

기본값"sentence"

허용 값

"sentence"
"word"
"word_streaming"

output_format?string

비스트리밍 오디오 출력 형태입니다. URL 결과의 유효 기간은 24시간입니다.

기본값"hex"

허용 값

"hex"
"url"

aigc_watermark?boolean

비스트리밍 오디오 끝에 AIGC 위변조 방지 워터마크 추가 여부입니다.

기본값false

응답 본문

`application/json`

curl -X POST "https://example.com/v1/minimax/t2a_v2" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "text": "안녕하세요, 오늘 날씨가 참 좋네요.",
    "stream": false,
    "voice_setting": {
      "voice_id": "male-qn-qingse"
    },
    "audio_setting": {
      "format": "mp3",
      "sample_rate": 32000
    }
  }'

{
  "data": {
    "audio": "49443304000000000000",
    "subtitle_file": "https://example.com/subtitle.json",
    "status": 2,
    "ced": ""
  },
  "trace_id": "trace_id_example",
  "extra_info": {
    "audio_length": 4200,
    "audio_sample_rate": 32000,
    "audio_size": 67200,
    "bitrate": 128000,
    "word_count": 12,
    "usage_characters": 12,
    "invisible_character_ratio": 0,
    "audio_format": "mp3",
    "audio_channel": 1
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

인증

요청 본문

응답 본문

200application/json

401application/json

`application/json`