Kitta Audio Docs
API 참조음성을 텍스트로
Back to site

음성을 텍스트로

Open API를 통해 오디오를 녹음합니다.

음성을 텍스트로

Speech to Text는 오디오 URL을 텍스트 및 선택적 세그먼트 메타데이터로 변환합니다. 업로드된 오디오, 통화 녹음, 작성자 워크플로 및 백엔드 전사 작업에 사용하세요.

POST /api/open/v1/speech/transcriptions
Authorization: Bearer KITTA_API_KEY
Content-Type: application/json

요구

{
  "audioUrl": "https://example.com/audio.mp3",
  "language": "en"
}

audioUrl는 API 서비스를 통해 연결할 수 있어야 합니다. 파일이 비공개인 경우 처리할 수 있을 만큼 오랫동안 유효하게 유지되는 단기 서명 URL을 생성하세요. language는 선택 사항입니다. 원본 언어를 알고 있는 경우 en, zh 또는 ru와 같은 언어 힌트를 사용하세요.

curl https://kittaai.com/api/open/v1/speech/transcriptions \
  -H "Authorization: Bearer KITTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audioUrl":"https://example.com/audio.mp3","language":"en"}'

응답

{
  "text": "This is the transcription result.",
  "duration": 12.4,
  "segments": [],
  "credits_used": 13,
  "quota_remaining": 987987
}

세그먼트 형태는 모델 및 계정 기능에 따라 다를 수 있습니다. 파서는 세그먼트 메타데이터를 선택 사항으로 처리하고 text를 기본 결과로 사용해야 합니다.

청구 및 크레딧

일반적으로 녹음 비용은 오디오 지속 시간을 기준으로 청구됩니다. 가능하다면 특히 사용자가 업로드한 녹음을 제출하기 전에 파일 기간을 확인하세요. 제품이 한 번에 많은 업로드를 허용하는 경우 작업을 대기열에 추가하고 배치 간 계정 잔액을 확인하세요.

오디오 처리가 시작되기 전에 요청이 실패하면 크레딧은 완료된 텍스트 변환과 동일하게 처리되어서는 안 됩니다. 운영 조정을 위해 응답 필드와 프로필 확인을 사용합니다.

오류

상태의미액션
400잘못된 URL, 지원되지 않는 오디오 또는 잘못된 형식의 JSON요청 수정
401API 키가 없거나 잘못되었습니다.자격 증명 새로 고침
402크레딧 또는 할당량이 부족합니다일괄 처리 중지
422오디오에 연결할 수 있지만 처리할 수 없습니다사용자에게 다른 파일을 요청하세요
500전사 서비스 실패URL이 유효한 경우 백오프로 재시도