API 키 받기

HeartMuLa Transcribe API

HeartMuLa

노래 보컬에서 가사를 받아 적어요, 다국어 지원

heartmula/transcribe/speech-to-text8크레딧부터/회 · US$0.08
  • 음성 텍스트 변환

HeartMuLa Transcribe 소개

HeartMuLa Transcribe는 오디오 파일에서 노래로 불린 가사를 뽑아 텍스트로 돌려줍니다. 오디오 필드 하나뿐이고 설정할 옵션은 없으며, 여러 언어를 다루고, 오디오 길이가 아니라 전사 1건 단위로 과금합니다.

POST /jobs/createTask에서 모델 이름을 heartmula/transcribe/speech-to-text(으)로 지정하면 호출할 수 있습니다. 8크레딧/회부터(US$0.08). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.

이 가이드는 당분간 영어로만 제공됩니다. →

요청 파라미터

파라미터필수설명
audio_url예사용할 목소리나 음악.

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션크레딧 /회≈ USD
기본7.5US$0.075

작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 8크레딧/회(US$0.08)입니다.

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

HeartMuLa Transcribe API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 heartmula/transcribe/speech-to-text, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 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을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

HeartMuLa Transcribe 더 알아보기