요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
audio_url | 예 | 사용할 목소리나 음악. |
filler_words | 아니요 | Keep filler words such as um and uh in the transcript. 기본값: false |
keyterms | 아니요 | Names and terms to spell the way you list them, up to 100. 기본값: [] |
language | 아니요 | 읽을 언어. ar · cs · da · nl · en · fil · fr · de · hi · id · it · ja · ko · mk · ms · fa · pl · pt · ro · ru · es · sv · th · tr · vi |
multichannel | 아니요 | Transcribe each channel separately, one line per channel. Turn on when speakers are on separate channels. 기본값: false |
text_normalization | 아니요 | Write spoken numbers, prices, dates and units in digits. Needs language. 기본값: false |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /초 | ≈ USD |
|---|---|---|
| 기본 | 0.01 | US$0.0001 |
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Grok STT API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 xai/grok-stt/speech-to-text, 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-stt/speech-to-text",
"input": {
"audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3"
}
}'
# 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 STT API 질문
Grok STT API 요금은 얼마인가요?
Grok STT 가격은 0.01크레딧(US$0.0001) /초입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Grok STT의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 음성 텍스트 변환: xai/grok-stt/speech-to-text을(를) 넣으세요.
무엇이 돌아오나요?
작업 결과의 텍스트로 받아쓰기가 돌아오고, 구조화된 받아쓰기(output.transcript)에 감지된 언어, 오디오 길이, 단어마다의 시작·종료 시각(초)이 담깁니다. multichannel을 켜면 채널별로 담깁니다. 내려받을 파일은 없습니다. 화자 라벨은 포함되지 않습니다.
화자를 구분할 수 있나요?
목소리로는 구분하지 못하며 화자 라벨은 반환되지 않습니다. 많은 통화 녹음처럼 화자마다 별도 채널에 녹음되었다면 multichannel을 켜세요. 채널마다 한 줄씩 돌아옵니다. 꺼 두면 한쪽이 빠질 수 있으며, 채널마다 다른 화자가 있는 두 번의 테스트에서 두 번 모두 한 명이 받아쓰기에서 빠졌습니다.
어떤 오디오를 보낼 수 있나요?
업로드한 MP3나 WAV, 또는 MP3·WAV·M4A·FLAC·OGG·Opus·AAC·MP4·MKV 같은 일반적인 형식의 공개 URL이며, 길이는 1초~2시간입니다. 파일 헤더가 없는 원시 오디오는 받지 않습니다.
Grok STT API의 제한은 무엇인가요?
최대 업로드 크기: 90 MB; 언어: 25. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Grok STT을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Grok STT을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

