요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
audio_url | 예 | 사용할 목소리나 음악. |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /회 | ≈ USD |
|---|---|---|
| 기본 | 7.5 | US$0.075 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 8크레딧/회(US$0.08)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
HeartMuLa Transcribe API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 heartmula/transcribe/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": "heartmula/transcribe/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 탭에 있어요.
HeartMuLa Transcribe API 질문
HeartMuLa Transcribe API 요금은 얼마인가요?
HeartMuLa Transcribe 가격은 8크레딧(US$0.08) /회입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 HeartMuLa Transcribe의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 음성 텍스트 변환: heartmula/transcribe/speech-to-text을(를) 넣으세요.
타임스탬프나 줄별 시간을 받을 수 있나요?
받을 수 없습니다. 출력은 가사 텍스트뿐이고 시간 정보도, 신뢰도 값도, 화자나 구간 라벨도 없습니다. 자막 작업에는 여전히 자체 정렬 과정이 필요합니다.
오디오가 어떤 언어인지 알려 줘야 하나요?
알려 줄 필요도 없고, 알려 줄 수도 없습니다. 모델이 여러 언어를 알아서 처리하며, 어떤 언어로 판단했는지는 알려 주지 않습니다.
노래가 아니라 말소리는 얼마나 잘 되나요?
음악 위에 얹힌 노래에 맞춰 둔 모델입니다. 말소리도 대개 전사되지만 인터뷰, 팟캐스트, 회의에는 범용 음성 인식 모델이 더 맞습니다.
코드 없이 HeartMuLa Transcribe을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 HeartMuLa Transcribe을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

