APICK STT API로 녹음 파일 전사하기: MP3 업로드와 구간 검수

10월 11, 2026

녹음 음성 파형을 구간별 전사 텍스트로 바꾸고 내용을 검수하는 STT 개념도 — 이해를 돕기 위한 AI 생성 개념 이미지입니다. 실제 API 응답 화면이 아닙니다.

확인일: 2026-10-11 · 공식 공개 문서 기반 · 아래 코드는 실행하지 않은 연동 예제입니다. 실제 키·고객 데이터는 포함하지 않았습니다.

녹음 파일에서 회의록 초안을 만드는 첫 단계

녹음 파일을 텍스트로 바꾸면 회의록의 검색과 검수가 쉬워집니다. 다만 STT가 뽑은 문장을 곧바로 확정 회의록으로 배포하기보다, 발언 구간과 원음으로 돌아갈 수 있게 만드는 것이 중요합니다. APICK STT를 연결할 때도 원음 식별자·구간 텍스트·검수 상태를 함께 관리하는 흐름으로 시작해 보세요.

REST 업로드 예제: mp3와 한국어 언어 코드

직접 확인한 최신 STT 문서는 POST /rest/stt에 Authorization: Bearer 헤더, multipart/form-data의 audio 파일과 language를 보내도록 안내합니다. 예제는 문서에 명시된 MP3와 ko를 사용합니다. TLS 검증을 끄는 옵션은 넣지 않았습니다. REST STT 명세

curl --fail-with-body --request POST https://apick.app/rest/stt \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form 'audio=@./sample-consented.mp3;type=audio/mpeg' \
  --form-string 'language=ko'

// Node.js 22+ 서버 예제. 녹음·전송 권한을 확인한 테스트 파일만 사용합니다.
import { readFile } from 'node:fs/promises';
const audio = await readFile('./sample-consented.mp3');
const form = new FormData();
form.append('audio', new Blob([audio], { type: 'audio/mpeg' }), 'sample.mp3');
form.append('language', 'ko');
const r = await fetch('https://apick.app/rest/stt', {
  method: 'POST', headers: { Authorization: `Bearer ${process.env.APICK_API_KEY}` },
  body: form, signal: AbortSignal.timeout(120000)
});
const result = await r.json();
if (!r.ok || result.api?.success === false || result.data?.success !== 1) {
  throw new Error(`변환 상태 확인 필요: HTTP ${r.status}`);
}
const transcript = result.data.text;
const segments = result.data.segments;
console.log({ transcript, segments, costPoints: result.api.cost });

전체 본문과 구간 데이터를 따로 쓰기

REST 문서는 전체 text와 segments의 start·end·text, language, duration을 설명합니다. 원음 재생 UI에서는 구간을 선택하면 해당 시작 위치로 이동하도록 연결할 수 있습니다. 요약 기능에 넘길 텍스트에는 원본 녹음 ID와 검수 여부를 붙여, 나중에 사실을 되짚어 볼 수 있게 하세요.

고유명사·숫자·여러 사람이 겹쳐 말한 구간은 사람이 직접 확인할 대상으로 분류하는 편이 좋습니다. 전사에 없는 발언자를 추정해서 붙이지 말고, 발언자 식별 기능의 지원 여부가 확인되지 않았다면 “발언자 미확인”으로 남기세요. 요약 모델을 뒤에 붙이더라도 불명확한 전사 내용을 임의로 확정하지 않게 지시해야 합니다.

MCP 방식은 파일 입력 계약이 다릅니다

MCP 도구 stt는 audio_url이라는 HTTPS URL을 받습니다. 공식 카탈로그에는 200MB와 artifact_filter 옵션이 안내되어 있으며, 전용 REST 페이지의 첨부 합계 1GB 안내와 구분해야 합니다. API별 지원 한도를 합쳐 “어디서든 1GB 가능”이라고 가정하지 마세요. 민감한 녹음의 공개 URL을 만들기보다는 업로드 방식을 먼저 검토합니다. MCP STT 설명

MCP의 artifact_filter=flag는 무음·잡음에서 의심되는 비음성 문구를 표시하는 옵션입니다. 검수 과정에서는 먼저 표시 모드로 원음과 대조하는 방법을 고려할 수 있습니다. 옵션이 모든 오인식을 해결한다고 보장할 수는 없습니다.

비용과 FAQ

2026-10-11 직접 확인한 STT 개발가이드는 기본 요금을 30초당 50P로 표시합니다. 따라서 60초를 두 단위로 계산한 예산 예시는 100P입니다. 30초 미만 구간의 올림·최소 청구 규칙은 확인하지 못했으므로 길이가 정확히 나누어지지 않는 파일은 추가 확인이 필요합니다. 실제 최종 차감액은 api.cost로 확인하세요. STT 30초 단위 요금표

이 예제에 비동기 폴링이 있나요? 전용 REST 문서의 요청·응답 계약에는 작업 ID 폴링을 안내하지 않습니다. 임의의 상태 조회 경로를 추가하지 않습니다. 녹음 파일을 바로 보내도 되나요? 참석자 고지·처리 권한·보관 규칙을 먼저 확인하고, 처음에는 개인정보가 없는 자체 테스트 녹음을 사용하세요.

공식 문서에서 다음 단계 확인하기

구현 전 현재 옵션·요금을 다시 확인하세요. STT REST 문서 · MCP STT 옵션 · MCP 요금·연동

#APICK #STT #음성인식 #회의록

이 블로그 검색

apick