Grind away: 오디오 텍스트 변환(STT) API · 파일 변환 자동화 · 호출당 과금 REST API

2026년 4월 22일 수요일

오디오 텍스트 변환(STT) API · 파일 변환 자동화 · 호출당 과금 REST API | APICK 에이픽

APICK · SERVICE BROCHURE · 파일 변환

오디오 텍스트 변환(STT) API

오디오 파일을 분석해 발화 내용을 텍스트로 변환하는 음성 인식(STT) API

💳 호출당 Not specified ⚡ 실시간 응답 🔐 단일 인증키 📡 REST 표준

About APICK

APICK 은 어떤 서비스인가요?

APICK(에이픽) 은 금융·사업자·부동산·신분증·OCR·이미지·문서까지 80여 종의 비즈니스 API 를 REST 표준으로 제공하는 호출당 과금 플랫폼 입니다. 단일 인증키 CL_AUTH_KEY 하나로 모든 API 를 사용할 수 있고, 월 최소 비용 없이 호출한 만큼만 과금되는 투명한 요금 정책이 특징입니다.

✅ 단일 인증키 · 80+ REST API 통합 사용 — 한 번 가입하면 추가 계약 없이 바로 확장
✅ 호출당 포인트 과금 · 월 최소 비용 없음 — 트래픽 규모와 무관하게 부담 없이 시작
✅ 실시간 응답 · 호출 메타 자동 제공 — api.cost · api.ms · api.pl_id 자동 기록

APICK 회원가입 · 지금 시작하기 →

왜 APICK 인가 · 3가지 핵심 강점

정찰제 · 투명 가격

모든 API 가격이 정찰제로 공개되어 누구나 동일한 조건으로 이용합니다.

가입 즉시 전체 사용

회원가입 후 포인트 충전만으로 80여 종 API 를 즉시 호출할 수 있습니다.

5분 연동 · 무심사

별도 인증·심사·계약 없이 가입 후 5분 안에 모든 API 를 연동합니다.

주요 서비스 분야

금융·계좌 인증

계좌 실명 조회 · 은행코드 · 1원 인증 · 거래영업일

사업자·기업

사업자 정보 · 벤처기업 · 휴폐업 · 세무 상태

부동산·등기

건축물대장 · 인터넷등기소 · 토지대장 · 공시지가

개인·신분증 인증

주민번호 진위 · 신분증 OCR·진위 · 개인통관부호

이미지·영상·음성

얼굴 감지·블러 · 워터마크 · STT · TTS · 음성 변환

웹·문서·주소·검색

구글·유튜브 · URL 스크린샷 · PDF·DOCX 변환 · 도로명

한눈에 보는 연동 사양

엔드포인트

/rest/stt

REST · POST 요청

호출 단가

정책 별도

후불제 정책 별도 · 호출당

응답 시간

api.ms

응답 본문 api.ms 값으로 확인

핵심 특장점 · 빠른 도입 포인트

연동 담당자가 가장 먼저 확인하면 좋은 6가지 포인트입니다.

최소 입력 · 즉시 응답

필수 파라미터만 전달하면 평균 10초 이내, 최대 35초 응답으로 실시간 검증이 가능합니다.

표준 인증 방식

CL_AUTH_KEY (MD5 인증키) 를 헤더로 전달. 별도 OAuth 흐름 없이 즉시 호출 가능합니다.

호출 메타 자동 제공

응답에 api.cost · api.ms · api.pl_id 가 함께 반환되어 과금·성능·결제 로그를 즉시 추적할 수 있습니다.

투명한 과금

선불제 호출당 과금 · 후불제 정책 별도. 응답 본문 api.cost 로 실제 차감 포인트를 확인합니다.

단순 REST 인터페이스

표준 POST 요청 + FormData 형식으로 어떤 언어·프레임워크에서도 즉시 통합 가능합니다.

실패 응답 처리

data.success 값으로 판단: 0 실패 · 1 성공 · 3 타임아웃. 실패 응답은 정책에 따라 과금되지 않을 수 있습니다.

도입 효과

호출 메타 자동 제공 · 표준 REST 인터페이스 · 실시간 응답으로 기존 서비스 흐름에 즉시 편입됩니다.

✅ 호출 메타 자동 제공

api.cost / api.ms / api.pl_id 로 호출당 과금·성능·결제 로그를 즉시 추적합니다.

✅ 표준 REST 인터페이스

단순 POST + FormData 구조로 어떤 언어·프레임워크에서도 즉시 통합됩니다.

✅ 실시간 응답

평균 10초 이내 응답으로 사용자 흐름 중간에 자연스럽게 호출할 수 있습니다.

연동 사양 요약

Method	POST
Endpoint	`https://apick.app/rest/stt`
Header	CL_AUTH_KEY(인증키(MD5))
FormData	값: audio, language
Response	data · api 객체
api 객체	success · cost · ms · pl_id
success 값	0 실패 · 1 성공 · 3 타임아웃
응답시간	api.ms 값으로 확인 · 네트워크 상황에 따라 변동
과금 단위	Not specified / 호출당

요청 파라미터

이름	타입	필수	설명
`audio`	File	필수	음성 파일
`language`	String	필수	추출 언어 (ko, en, zh, de, es, fr, ja)

요청 예시 · cURL

공식 가이드 기준 파라미터를 FormData 로 전달, 인증키는 헤더로 전달합니다.

curl -k -X POST "https://apick.app/rest/stt" \
  -H "CL_AUTH_KEY: $API_KEY" \
  -F "audio=sample" \
  -F "language=sample"

응답 예시 · JSON 샘플

표준 응답 구조 샘플입니다. 실제 필드·값은 호출 대상에 따라 달라질 수 있으며, 정확한 스펙은 공식 개발가이드를 기준으로 확인하세요.

{
  "data": {
    "text": " 절기상 대설인 오늘은 일교차를 유의하셔야겠습니다. 현재 서울 기온 1.3도로 어제 같은 시간보다 다소 공기가 차가워졌는데요. 어제 내린 비가 얼어붙은 곳이 있어서 도로 살얼음 유의하셔야겠고요. 낮부터는 기온이 오르면서 비교적 온화하겠습니다. 현재 제주와 일부 전남과 경남, 동해안을 중심으로는 강풍특보가 발효 중이고요. 건조주의보까지 이어지는 곳들이 있어서 시설물 관리와 각종 화재 사고 발생하지 않도록 주의하셔야겠습니다. 오늘은 전국 하늘 미세먼지 걱정 없이 대체로 쾌청하게 드러나겠습니다. 자자한 현재 기온을 살펴보시면 서울 1.3도, 광주 6.3도, 부산 7.1도로 출발하고 있고요. 낮이 되면 서울 11도, 전주와 광주, 부산 13도까지 오르는 등 비교적 포근하겠습니다. 당분간 뚜렷한 비 소식 없겠고요. 금요일인 내일은 서울 낮 기온 16도까지 오르는 등 예년보다 온화한 날들이 이어지겠습니다. 날씨였습니다.",
    "segments": "[16 segment objects with id, start, end, text fields]",
    "language": "ko",
    "duration": 71.088,
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 100,
    "ms": 7929,
    "pl_id": 1595684
  }
}

응답 필드

경로	타입	설명
`data`	Object	조회 데이터
`data.text`	String	전체 추출 텍스트
`data.segments`	Array	구간별 데이터
`data.segments[].id`	Integer	구간 ID
`data.segments[].start`	Double	시작 구간
`data.segments[].end`	Double	끝 구간
`data.segments[].text`	String	추출 텍스트
`data.language`	String	추출 언어
`data.duration`	Double	재생 시간
`data.success`	Integer	과금 여부 (0: 실패, 1: 성공, 3: 실패(timeout))
`api`	Object	API 호출 공통 데이터
`api.success`	Boolean	API 서버 정상 응답 여부
`api.cost`	Integer	API 호출 요금
`api.ms`	Integer	API 응답 시간
`api.pl_id`	Integer	API 결제 로그 ID

도입 체크리스트

Checklist

연동 작업 전 확인이 필요한 항목

✓APICK 회원가입 후 인증키(CL_AUTH_KEY) 발급

✓선불제 포인트 충전 또는 후불제 약정

✓호출 IP 화이트리스트 설정 검토

✓응답 객체 파싱 및 빈 값 처리 정책 수립

✓타임아웃(35초) 대응 로직 구현

✓api.cost 기반 과금 모니터링 구성

📄 오디오 텍스트 변환(STT) API 가이드 PDF 다운로드

지금 바로 APICK 에 연동해보세요

회원가입 즉시 CL_AUTH_KEY 발급.
오디오 텍스트 변환(STT) API 는 호출당 정책 별도, 월 최소 비용 없이 호출한 만큼만 과금됩니다.

APICK 회원가입 · 지금 시작하기 → 공식 개발 가이드 보기

* 본 문서는 APICK 공식 스펙을 바탕으로 정리한 연동 참고 자료입니다. 최신·정확한 스펙은 공식 개발 가이드 를 기준으로 확인하세요.

#APICK #에이픽 #비즈니스API #호출당과금API #RESTAPI #단일인증키API #월최소비용없는API #개발자API #오디오텍스트변환(STT)API

Grind away