소개
오디오 URL과 함께 필요하면 말한 언어, 핵심 용어 목록, 스위치 세 개(숫자 표기 변환, 군말 유지, 채널별 받아쓰기)를 보냅니다. 작업은 받아쓰기를 텍스트로 반환하고, 단어별 타이밍·감지된 언어·오디오 길이가 담긴 구조화된 받아쓰기도 함께 반환합니다. 파일은 만들어지지 않습니다. SpicyAPI는 콘텐츠 필터를 적용하지 않으며, 검열 없는 발화도 말한 그대로 받아적습니다. 오디오 1초마다 과금됩니다.
| 항목 | 값 |
|---|---|
| 입력 | 오디오 |
| 출력 | 텍스트 |
| 필수 필드 |
|
| 선택 필드 | language(25개 코드), |
| 결과 | 텍스트 받아쓰기와, 단어 타이밍·언어·길이를 담은 output.transcript, multichannel이면 채널별 |
| 과금 수량 | 오디오 초 수, 업로드한 파일은 실제 길이만큼, URL은 최대 2시간 분량을 잡아 둠 |
| 일반적인 시간 | 10초 클립에 약 3초, 1시간에 약 15초 |
| 보관 기간 | 업로드한 오디오는 하루 뒤 삭제, 받아쓰기는 프롬프트 데이터와 함께 삭제 |
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
audio_url | 예 | 받아쓸 오디오입니다. 업로드한 MP3나 WAV, 또는 MP3·WAV·M4A·FLAC·OGG·Opus·AAC·MP4·MKV의 공개 URL을 넣습니다. 1자 이상 |
language | 아니요 | 말한 언어의 언어 코드입니다. 비워 두면 언어가 자동 감지되며, 어느 쪽이든 지원 언어의 발화는 받아써집니다. |
text_normalization | 아니요 | 켜면 말로 된 숫자, 가격, 날짜, 단위를 아라비아 숫자로 적습니다(단어 대신 ‘$1,250’, ‘March 14’). language가 필요합니다. 기본값: |
keyterms | 아니요 | 받아쓰기에서 우선하도록 할 단어나 짧은 구를 최대 100개(각 50자까지) 넣습니다. 이름, 브랜드명, 전문 용어에 씁니다. 기본값: |
filler_words | 아니요 | 켜면 um, uh 같은 군말을 받아쓰기에 남기고, 꺼짐(기본값)이면 지웁니다. 가격에는 영향을 주지 않습니다. 기본값: |
multichannel | 아니요 | 켜면 다채널 파일(최대 8채널)의 각 채널을 따로 받아써 채널 순서대로 한 줄씩 돌려줍니다. 화자가 채널마다 따로 녹음된 경우에 씁니다. 기본값: |
요금
$0.00003 / 오디오 1초
오디오 1초마다 과금됩니다. 작업을 만들 때 업로드한 오디오는 실제 길이만큼, 오디오 URL은 최대치인 2시간 분량의 금액을 잡아 두고, 실제 길이만큼 결제하며 나머지는 해제됩니다. 실패한 요청은 과금되지 않습니다.
활용 사례
음성 메모와 오디오 스토리
검열 없는 발화도 말한 그대로 받아적히므로, 음성 메시지, 롤플레이 녹음, 오디오 스토리를 텍스트로 검색하고 자막을 달거나 편집할 수 있습니다.
통화 녹음
양쪽이 각자 다른 채널에 담긴 녹음은 multichannel을 켜면 한 사람당 한 줄로 돌아옵니다. 끈 상태에서는 테스트에서 한쪽만 돌아왔으므로 채널이 나뉜 통화에는 켜 두세요.
생성된 음성 검수
텍스트 음성 변환 결과를 다시 받아써서 대본과 비교하면 건너뛴 단어, 잘린 끝부분, 소리 내어 읽힌 태그가 바로 드러납니다.
이름, 브랜드, 숫자
드문 이름을 핵심 용어로 등록하고 text normalization을 켜면, 이름은 원하는 철자로, 가격과 날짜는 $1,250이나 March 14 같은 표기로 받아씁니다.
프롬프트 가이드 및 실전 팁
audio_url로 오디오 가리키기
MP3나 WAV를 업로드하거나 오디오 자체를 반환하는 공개 URL을 넘깁니다. HTML을 반환하는 플레이어 페이지나 공유 링크는 실패합니다. 길이는 1초~2시간입니다.
아는 정보 더하기
언어를 알면 language를 설정하고, 이름과 브랜드명을 keyterms에 나열하고, 숫자를 아라비아 숫자로 적으려면 text_normalization을 켭니다. text_normalization에는 language가 필요합니다.
작업에서 텍스트 읽기
받아쓰기는 작업 결과의 텍스트로 도착하고, output.transcript에는 단어마다 시작·종료 시각이 나열됩니다. multichannel을 켜면 채널 순서대로 채널마다 한 줄입니다. 나중에 필요하면 직접 스토리지에 복사해 두세요.
반환되는 것
작업 결과의 텍스트로 된 받아쓰기에 더해, output.transcript에 감지된 언어와 언어 코드, 오디오 길이(초), 단어마다의 시작·종료 시각(초)이 담깁니다. multichannel을 켜면 output.transcript.channels에 채널마다 같은 내용이 담깁니다. 파일은 만들어지지 않고 미디어 스토리지에도 아무것도 들어가지 않습니다. 화자 라벨은 포함되지 않습니다.
오디오 보내기
audio_url에는 업로드한 MP3나 WAV, 또는 MP3·WAV·M4A·FLAC·OGG·Opus·AAC·MP4·MKV의 공개 URL을 넣으며 길이는 1초~2시간입니다. URL은 오디오 자체를 반환해야 합니다. 파일 헤더가 없는 원시 오디오(PCM, μ-law, A-law)는 받지 않습니다.
언어와 숫자
language를 비워 두면 언어가 자동 감지되며, 어느 쪽이든 지원하는 25개 언어의 발화는 받아써집니다. 언어를 지정하고 text_normalization을 켜면 숫자, 가격, 날짜, 단위가 문자 표기로 바뀝니다. 테스트에서는 ‘one thousand two hundred fifty dollars on March fourteenth’가 ‘$1,250 on March 14’가 되었습니다. text_normalization에는 language가 필요합니다.
핵심 용어와 군말
keyterms에는 50자 이하의 용어를 한 줄에 하나씩 최대 100개까지 넣습니다. 테스트에서 ‘Xandrelle’과 ‘Qorvessa’는 등록하지 않으면 ‘Xandrel’, ‘Corvessa’로, 등록하면 정확히 돌아왔습니다. filler_words는 기본적으로 지워지는 um과 uh를 남깁니다.
여러 채널
화자마다 채널이 나뉜 녹음에는 multichannel을 켭니다. 채널마다 따로 받아써 채널 순서대로 한 줄씩 돌려줍니다. 모든 채널에 같은 소리가 담긴 경우에만 꺼 두세요. 테스트에서 좌우에 다른 화자가 있는 스테레오 파일은 두 사람 중 한 명이 빠진 채 돌아왔습니다.
과금
오디오 1초마다 과금됩니다. 작업을 만들 때 업로드한 오디오는 실제 길이만큼, 오디오 URL은 최대치인 2시간 분량의 금액을 잡아 두고, 실제 길이만큼 결제하며 나머지는 해제됩니다. 어떤 옵션도 가격에 영향을 주지 않습니다. 실패한 요청은 과금되지 않습니다.
콘텐츠
SpicyAPI는 콘텐츠 필터를 추가하지 않습니다. 테스트에서 검열 없는 발화가 별표, 삐 소리, 누락 없이 한 단어도 빠짐없이 그대로 돌아왔습니다.
SpicyAPI는 콘텐츠 필터를 더하지 않으며, 발화는 가리거나 거부하지 않고 말한 그대로 받아적습니다. 보내는 오디오에 대한 권리와 녹음된 사람들의 동의는 사용자가 책임집니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "xai/grok-stt/speech-to-text",
"input": {
"audio_url": "https://example.com/reference.mp3"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.





