SpeakNotes API, MCP 서버 및 OAuth 플랫폼
오디오, 비디오 및 YouTube 링크를 코드에서 직접 스크립트와 구조화된 요약으로 변환하거나, MCP를 통해 AI 에이전트가 수행하도록 하세요. 모든 계정은 키를 생성하고 샌드박스에서 무료로 시작할 수 있습니다.
- 대시보드에서 직접 키를 생성하세요. 영업 문의나 대기 명단 없이 즉시 이용 가능합니다.
- 샌드박스 키는 고정된 출력값을 반환하며, 크레딧을 소모하지 않고 실제 노트에 영향을 주지 않습니다.
- Claude, ChatGPT 및 Cursor가 SpeakNotes를 기본적으로 사용할 수 있도록 지원하는 호스팅된 MCP 서버입니다.
첫 요약을 위한 세 번의 요청
샌드박스 키로 시작하여 데이터 구조를 익히고, 응답이 올바르게 나오면 라이브 키로 교체하세요.
- 1
키 생성
설정에서 API 키를 열고 키를 생성하세요. 테스트를 위해 샌드박스를 선택하거나, 실제 오디오를 처리하려면 라이브를 선택하세요.
# Any signed-in account can create one. Sandbox keys start sn_test_. open https://speaknotes.io/settings/api-keys
- 2
API 호출
키를 베어러 토큰으로 전송하세요. 요약, 전사, YouTube 작업이 인라인으로 응답됩니다.
curl -X POST https://api.speaknotes.io/v1/summaries \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text": "...your transcript...", "styleId": "meeting-notes"}' - 3
긴 미디어 업로드
업로드는 백그라운드에서 실행됩니다. 업로드를 생성하고, 파일을 PUT으로 전송하고, 완료한 다음 노트가 완료될 때까지 폴링하세요.
# 1. create the upload curl -X POST https://api.speaknotes.io/v1/uploads \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \ -H "Content-Type: application/json" \ -d '{"fileName": "standup.m4a", "contentType": "audio/mp4"}' # 2. PUT the file to uploadUrl, then complete it curl -X POST https://api.speaknotes.io/v1/uploads/NOTE_ID/complete \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY" # 3. poll until status is Done curl https://api.speaknotes.io/v1/notes/NOTE_ID/status \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY"
플랫폼이 제공하는 기능
읽기 및 쓰기가 가능한 REST API
노트와 폴더를 나열, 생성, 업데이트, 삭제하세요. 오디오 전사, 텍스트 요약, YouTube 링크 요약이 가능합니다. 모든 작업은 OpenAPI 3.1 사양을 따릅니다.
호스팅된 MCP 서버
api.speaknotes.io/mcp에서 스트리밍 가능한 HTTP를 제공하며, 동일한 읽기 및 쓰기 작업을 수행하는 13개의 도구를 포함합니다. 에이전트는 OAuth 또는 키를 통해 연결됩니다.
PKCE를 사용하는 OAuth 2.1
다른 SpeakNotes 사용자를 대신하여 작동하는 앱을 구축하세요. 동적 클라이언트 등록을 통해 MCP 클라이언트는 키를 복사할 필요 없이 스스로 등록하고 연결할 수 있습니다.
진정한 샌드박스
sn_test_로 시작하는 키는 모든 경로, 유효성 검사 규칙 및 응답 형태를 고정된 출력에 대해 실행합니다. 크레딧이나 모델 호출 비용이 발생하지 않으며, 쓰기 작업은 별도의 샌드박스 라이브러리에 저장됩니다.
확인 가능한 크레딧
1크레딧은 미디어 1분 처리에 해당합니다. 비용이 발생하는 모든 응답은 청구된 금액과 잔액을 반환하므로, 에이전트가 시작 전에 확인할 수 있습니다.
범위가 지정된 자격 증명
키나 앱에 필요한 권한만 부여하세요. 읽기 전용 키는 노트를 나열할 수는 있지만 삭제할 수는 없습니다.
가격
모든 계정은 매달 초기화되는 크레딧을 제공받습니다. Pro 계정은 훨씬 더 많은 크레딧을 받습니다. 그 외에는 크레딧을 선불로 구매하므로, 재시도 루프가 반복되어도 요금이 과도하게 청구되지 않습니다.
참조
- 퀵스타트curl을 사용하여 요약 기능을 즉시 구현해보세요.
- 인증 및 범위API 키, 샌드박스 키, 범위 및 속도 제한.
- OAuth 2.1PKCE를 포함한 인증 코드, 동적 클라이언트 등록, 새로 고침 및 취소.
- 오류 코드API가 반환할 수 있는 모든 코드와 각 코드에 대한 대응 방법.
- 크레딧 및 가격각 작업의 비용 및 충전 방법.
- OpenAPI 3.1 사양모든 작업에 대한 기계 판독 가능한 계약.
- MCP 매니페스트/.well-known/mcp.json에서의 서버 이름, 전송 및 도구 목록.
- 에이전트 스킬 파일에이전트 런타임을 위한 드롭인 SKILL.md.
개발자 자주 묻는 질문
- SpeakNotes API는 무료로 사용할 수 있나요?
- 모든 계정은 매달 60크레딧을 무료로 제공받으며, 샌드박스 키는 무제한으로 영원히 무료입니다. Pro 계정은 매달 2,000크레딧을 제공받습니다. 월간 제공량을 초과하면 선불 크레딧 팩을 구매할 수 있습니다.
- SpeakNotes API 키는 어떻게 얻나요?
- 로그인 후 설정의 API 키 섹션을 여세요. 직접 키를 생성하면 즉시 작동합니다. 별도의 신청 절차나 문의 양식은 없습니다.
- SpeakNotes에 샌드박스 환경이 있나요?
- 네. 샌드박스 옵션으로 생성한 모든 키는 sn_test_로 시작합니다. 이 키는 모델을 호출하거나 크레딧을 소모하거나 실제 노트에 기록하지 않고도 모든 경로를 실행하고 고정된 실제 같은 결과를 반환합니다.
- SpeakNotes를 Claude나 다른 MCP 클라이언트에 어떻게 연결하나요?
- Streamable HTTP를 통해 클라이언트를 https://api.speaknotes.io/mcp로 지정하세요. OAuth를 지원하는 클라이언트는 스스로 등록하고 인증을 요청하며, 지원하지 않는 클라이언트는 SpeakNotes API 키를 베어러 토큰으로 보낼 수 있습니다.
- SpeakNotes API는 OAuth를 지원하나요?
- 네. SpeakNotes는 PKCE, 리프레시 토큰 로테이션, 동적 클라이언트 등록 및 취소 기능을 갖춘 OAuth 2.1 인증 서버를 운영합니다. 메타데이터는 https://speaknotes.io/.well-known/oauth-authorization-server에서 확인할 수 있습니다.
- SpeakNotes API의 속도 제한은 어떻게 되나요?
- 자격 증명당 분당 읽기 요청 120회, 쓰기 요청 30회, 처리 요청 10회로 제한됩니다. 모든 응답의 속도 제한 헤더에 남은 할당량이 포함되며, 429 오류 발생 시 대기 시간을 정확히 알려줍니다.