TokenLab

오디오 및 실시간

음성 생성

입력 텍스트로부터 오디오를 생성합니다

POST
/v1/audio/speech

현재 음성 모델을 확인하려면 GET /v1/models?recommended_for=tts를 사용하세요.

요청 본문

응답 모드는 선택한 모델과 stream_format에 따라 달라집니다. 긴 입력 텍스트의 경우 HTTP 클라이언트 타임아웃을 최소 120s 이상으로 설정하세요.

선택적 필드, 음성, 출력 형식 및 SSE 지원 여부는 선택한 모델에 따라 다릅니다. 요청을 전송하기 전에 GET /v1/models/{model}을 확인하세요. 지원되지 않는 매개변수는 400 unsupported_parameter를 반환할 수 있습니다.

modelstring필수

TTS 모델 ID입니다. GET /v1/models?recommended_for=tts를 통해 현재 선택 가능한 항목을 확인하세요. 기본 모델은 제공되지 않습니다.

inputstring필수

오디오를 생성할 텍스트입니다. 최대 4,096자이며, 모델에 따라 더 낮은 제한이 적용될 수 있으므로 모델의 세부 정보를 참조하세요.

voicestring | object

음성 선택기입니다. grok-tts의 eve와 같이 모델 세부 정보의 음성 이름을 전달하거나, 음성 ID를 지원하는 모델의 경우 { "id": "voice-id" }와 같은 객체를 전달하세요.

voice_idstring

speech-2.8-turbo와 같이 이 매개변수를 지원하는 모델을 위한 음성 ID입니다.

instructionsstring

이 매개변수를 지원하는 모델을 위한 스타일 또는 전달 방식 지침(선택 사항)으로, 최대 2,000자까지 지원됩니다.

promptstring

qwen3-tts-1-7b-voicedesign과 같이 이 매개변수를 지원하는 모델을 위한 말하기 스타일 프롬프트(선택 사항)로, 최대 2,000자까지 지원됩니다.

language_codestring

이를 지원하는 모델을 위한 언어 코드(예: en-US)입니다.

response_formatstring

오디오 형식입니다. 허용되는 값은 모델에 따라 다릅니다. 예를 들어 grok-tts는 mp3만 반환하고, qwen3-tts-flash는 wav를 반환합니다. 값을 전송하기 전에 모델 세부 정보를 확인하세요.

stream_formatstring기본값: audio

TokenLab 전송 형식: audio 또는 sse. 모델 세부 정보에 명시된 경우에만 sse를 전달하세요.

speednumber

이를 지원하는 모델을 위한 음성 속도입니다. TokenLab은 0.25에서 4.0까지 지원하며, 모델에 따라 지원 범위가 더 좁을 수 있습니다.

temperaturenumber

이 매개변수를 지원하는 모델을 위한 샘플링 온도로, 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를 허용합니다.

응답 예시

응답

200 OK
<binary audio data>

주요 필드

Content-Typestring

HTTP 응답 미디어 타입: 오디오 형식 또는 SSE의 경우 text/event-stream입니다.

bodybinary | SSE

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
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

헤더

X-TokenLab-Delivery-Policy?string

요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.

허용 값

  • "auto"
  • "verified"
  • "official"

요청 본문

application/json

응답

application/json

application/json

application/json

application/json

application/json

application/json