오디오 및 실시간
음성 생성
입력 텍스트로부터 오디오를 생성합니다
현재 음성 모델을 확인하려면 GET /v1/models?recommended_for=tts를 사용하세요.
요청 본문
응답 모드는 선택한 모델과 stream_format에 따라 달라집니다. 긴 입력 텍스트의 경우 HTTP 클라이언트 타임아웃을 최소 120s 이상으로 설정하세요.
선택적 필드, 음성, 출력 형식 및 SSE 지원 여부는 선택한 모델에 따라 다릅니다. 요청을 전송하기 전에 GET /v1/models/{model}을 확인하세요. 지원되지 않는 매개변수는 400 unsupported_parameter를 반환할 수 있습니다.
TTS 모델 ID입니다. GET /v1/models?recommended_for=tts를 통해 현재 선택 가능한 항목을 확인하세요. 기본 모델은 제공되지 않습니다.
오디오를 생성할 텍스트입니다. 최대 4,096자이며, 모델에 따라 더 낮은 제한이 적용될 수 있으므로 모델의 세부 정보를 참조하세요.
음성 선택기입니다. grok-tts의 eve와 같이 모델 세부 정보의 음성 이름을 전달하거나, 음성 ID를 지원하는 모델의 경우 { "id": "voice-id" }와 같은 객체를 전달하세요.
speech-2.8-turbo와 같이 이 매개변수를 지원하는 모델을 위한 음성 ID입니다.
이 매개변수를 지원하는 모델을 위한 스타일 또는 전달 방식 지침(선택 사항)으로, 최대 2,000자까지 지원됩니다.
qwen3-tts-1-7b-voicedesign과 같이 이 매개변수를 지원하는 모델을 위한 말하기 스타일 프롬프트(선택 사항)로, 최대 2,000자까지 지원됩니다.
이를 지원하는 모델을 위한 언어 코드(예: en-US)입니다.
오디오 형식입니다. 허용되는 값은 모델에 따라 다릅니다. 예를 들어 grok-tts는 mp3만 반환하고, qwen3-tts-flash는 wav를 반환합니다. 값을 전송하기 전에 모델 세부 정보를 확인하세요.
audioTokenLab 전송 형식: audio 또는 sse. 모델 세부 정보에 명시된 경우에만 sse를 전달하세요.
이를 지원하는 모델을 위한 음성 속도입니다. TokenLab은 0.25에서 4.0까지 지원하며, 모델에 따라 지원 범위가 더 좁을 수 있습니다.
이 매개변수를 지원하는 모델을 위한 샘플링 온도로, 0에서 2 사이의 값입니다.
응답
stream_format=audio인 경우 응답에 오디오 바이트가 포함됩니다. stream_format=sse를 지원하는 모델은 text/event-stream 응답을 반환하므로, 전체 응답을 오디오 파일로 저장하는 대신 이벤트를 파싱하세요.
요청
curl -X POST "https://api.tokenlab.sh/v1/audio/speech" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-tts",
"voice": "eve",
"input": "Hello, welcome to TokenLab!"
}' \
--output speech.mp3음성 샘플
음성은 모델에 따라 다릅니다. 값을 전송하기 전에 GET /v1/models/{model}의 모델 세부 정보에서 voice 값을 확인하세요. 예를 들어 grok-tts는 eve, ara, rex, sal, leo를 허용합니다.
응답
<binary audio data>주요 필드
HTTP 응답 미디어 타입: 오디오 형식 또는 SSE의 경우 text/event-stream입니다.
audio의 경우 오디오 바이트이며, sse의 경우 이벤트 스트림입니다. Content-Type과 요청한 모드를 사용하여 파서를 선택하세요.
MiniMax Speech 2.8 Turbo는 속도에 중점을 둔 워크플로를 통해 선택한 음성으로 대본을 합성하며, 빠른 응답이 필요한 음성 인터페이스 및 내레이션에 유용합니다.
{
"model": "speech-2.8-turbo",
"input": "Welcome to TokenLab.",
"voice_id": "male-qn-qingse",
"speed": 1,
"response_format": "mp3",
"stream_format": "audio"
}인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
헤더
요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.
허용 값
- "auto"
- "verified"
- "official"
요청 본문
application/json
응답
application/json
application/json
application/json
application/json
application/json
application/json