Grok TTS 소개
2026년 3월 정식 출시된 xAI의 Grok 텍스트 음성 변환입니다.
POST /jobs/createTask에서 모델 이름을 xai/grok-tts/text-to-speech(으)로 지정하면 호출할 수 있습니다. 3크레딧/1,000자부터(US$0.03). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
text | 예 | The words to be spoken, with optional speech tags such as [laugh] or <whisper>…</whisper>. Billed per 1,000 characters, tags included. |
speed | 아니요 | 말하는 속도. ≥ 0.7 · ≤ 1.5 · 기본값: 1 |
bitrate | 아니요 | MP3 bit rate in bits per second. Only applies to mp3. 32000 · 64000 · 96000 · 128000 · 192000 · 기본값: 128000 |
language | 아니요 | 읽을 언어. auto · en · zh · ar-EG · ar-SA · ar-AE · bn · fr · de · hi · id · it · ja · ko · pt-BR · pt-PT · ru · es-MX · es-ES · tr · vi · 기본값: auto |
voice_id | 아니요 | 사용 가능한 목소리 중에서 고릅니다. ara · eve · leo · rex · sal · jpi39icg · d18jlf6v · 33g9t0jl · 26w6ihxi · dr8gqysu · wy0m9l5w · om17cury · x7avnu1k · bcs7l2c3 · hqxr4yub · h27ltdnz · 89q2pnko · 73xd5dum · 0p0rt7o1 · hbxkrnwm · 69smp8rm · yis75yfp · ekhwx401 · jupvcf34 · 0hhfxxqq · 0ih5oi34 · gwnexu6y · 97zmdc6s · fc7de6afcf6c · 7a9ee820b342 · 0895a5b8ce5c · f8cf5c2c78d4 · 96819d0bd28d · 79f3a8b96d43 · 78a495fdbb39 · e22152e06fd8 · 490ea3be50b1 · 1f046a033914 · dfe7b9e7d217 · c3a2c594479e · 83c6f4fea98e · 34fd4dce1ba3 · d634b6da3d3b · 670a0c3ac005 · 182a91893636 · d0cb9ff07d95 · b1a7441b97a1 · bf9fe5b5f981 · b5ae17439907 · a0401c9101f8 · 23be42535a45 · abfbdf26f115 · 6da5baee46d0 · 3d030bc92a87 · a13662ba951c · 58d27475085e · 247783ebdd51 · 244e27b39200 · 97fabd54445f · 37329fd8895a · 2badb5f46b1e · 1b12d5daee6b · 908c4626660f · 4ff93971bfdc · 70013edeb8e8 · 35c8d7f60dc8 · 23468361b4ef · 458705c07139 · 41321eb41295 · 40f31906b23d · 3a7889066fa2 · 기본값: eve |
sample_rate | 아니요 | Sample rate in Hz. 8000 for phone lines, 44100 or 48000 for studio work. 8000 · 16000 · 22050 · 24000 · 44100 · 48000 · 기본값: 24000 |
output_format | 아니요 | 결과 파일 형식. mp3 · wav · pcm · mulaw · alaw · 기본값: mp3 |
text_normalization | 아니요 | Rewrite numbers, abbreviations and symbols as spoken words before reading. 기본값: false |
optimize_streaming_latency | 아니요 | Streaming latency level: 0 best quality, 1 smaller first chunk, 2 smallest first chunk with more quality trade-off at chunk boundaries. 0 · 1 · 2 · 기본값: 0 |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /1,000자 | ≈ USD |
|---|---|---|
| 기본 | 2.7 | US$0.027 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 3크레딧/1,000자(US$0.03)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Grok TTS API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 xai/grok-tts/text-to-speech, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "xai/grok-tts/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "eve",
"language": "auto"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Grok TTS API 질문
Grok TTS API 요금은 얼마인가요?
Grok TTS 가격은 3크레딧(US$0.03) /1,000자입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Grok TTS의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 텍스트 음성 변환: xai/grok-tts/text-to-speech을(를) 넣으세요.
웃음, 쉼, 속삭임은 어떻게 넣나요?
텍스트에 직접 적습니다. [pause]·[laugh]·[breath]·[sigh] 같은 단발 태그는 그 위치에서 소리를 하나 내고, <whisper>…</whisper>·<slow>…</slow>·<build-intensity>…</build-intensity> 같은 감싸기 태그는 안에 든 말의 전달 방식을 바꿉니다. 태그는 읽히지 않고 연기되며(사용한 태그는 음성을 받아 적은 결과에 하나도 나타나지 않았습니다), 글자 수에는 포함됩니다.
어떤 언어와 보이스를 쓸 수 있나요?
Eve, Ara, Leo, Rex, Sal은 지원하는 모든 언어를 말하고, 나머지 66가지는 각각 한 언어에 맞춰져 있으므로 대본과 같은 언어의 보이스를 고르세요. language에는 auto 또는 20가지 언어 코드 중 하나를 넣습니다. 네덜란드어·폴란드어·스웨덴어·핀란드어·덴마크어·태국어 보이스에는 전용 코드가 없으므로 language를 auto로 두세요.
실존 인물의 목소리를 복제할 수 있나요?
아니요. 이 엔드포인트에서는 71가지 프리셋 보이스만 제공하며, 복제나 참조 음성 업로드는 없습니다.
Grok TTS API의 제한은 무엇인가요?
텍스트 길이(글자): 15,000; 목소리: 71; 언어: 20. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Grok TTS을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Grok TTS을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.