API 키 및 MCP
API 키를 생성하고 모든 공용 REST 엔드포인트를 호출하며 공식 Speechdash MCP 서버에 연결합니다.
설정 → API를 사용하여 키를 생성하고 어시스턴트를 연결합니다. 같은 sh_live_… 키는 공용 REST API 및 공식 MCP 서버를 인증합니다. 설정 → 연결기 아래의 연결기는 외부 MCP 서버를 앱 내 채팅에 연결하는 다른 기능입니다.
키 생성
- 설정 → API를 엽니다.
- 새 키를 클릭하고 이름을 지정합니다 (예:
프로덕션 서버) 그리고 즉시 복사합니다. 접두사만 저장되며, 전체 비밀은 한 번만 표시됩니다. - 서버에서
Authorization: Bearer sh_live_…를 전송합니다. 브라우저, 모바일 앱, 또는 공용 저장소에 키를 넣지 마세요.
최대 10개의 활성 키를 유지할 수 있습니다. 같은 페이지에서 누출된 키를 취소할 수 있습니다.
GET /v1/me로 키를 확인합니다 (이메일, 플랜, 지갑). 베이스 URL: https://api.speechdash.com/v1.
REST 엔드포인트
모든 공용 HTTP 경로는 다음과 같습니다:
| 메서드 | 경로 | 목적 |
|---|---|---|
GET | /health | 서비스 상태 (API 키 필요 없음; /v1 아래에 없음) |
GET | /v1/openapi.json | OpenAPI 3.1 계약 |
GET | /v1/me | 계정, 플랜, 지갑 |
GET | /v1/documents | 라이브러리 문서 목록 (완료된 전사본 포함) |
POST | /v1/documents | 텍스트 문서 생성 (source=api) |
GET | /v1/documents/{document_id} | 문서와 텍스트 읽기 |
PUT | /v1/documents/{document_id} | 제목, 텍스트, 언어, is_archived, 또는 visibility 업데이트 |
DELETE | /v1/documents/{document_id} | 문서 삭제 |
POST | /v1/documents/{document_id}/translate | 새 번역 버전 (MP3 내보내기와 같은 크레딧 사용) |
GET | /v1/documents/{document_id}/export | pdf, docx, txt, csv, srt, 또는 vtt 다운로드 |
POST | /v1/audio/speech | 최대 5,000자의 음성 합성 (JSON + 오디오) |
POST | /v1/audio/stream | WAV 스트리밍, 최대 20,000자 |
POST | /v1/audio/stream/with-timestamps | 문장별 오디오와 마크가 포함된 SSE |
GET | /v1/voices | 음성 목록 |
GET | /v1/voices/{voice_id} | 하나의 음성 프리셋 (예: F1) |
API는 오디오 또는 비디오 전사 작업을 시작하지 않습니다. 완료된 작업은 라이브러리 문서로 나타납니다 (source=transcription). 상호작용 가능한 테스트 페이지: 계정, 문서, 오디오, 음성.
MCP 도구
공식 서버 https://mcp.speechdash.com/mcp는 라이브러리 또는 음성 작업당 하나의 도구를 노출합니다. ChatGPT는 OAuth를 사용합니다. Cursor와 Claude Desktop는 Streamable HTTP와 개인 API 키를 사용합니다.
| MCP 도구 | REST |
|---|---|
speechdash_get_account | GET /v1/me |
speechdash_list_documents | GET /v1/documents |
speechdash_get_document | GET /v1/documents/{document_id} |
speechdash_create_document | POST /v1/documents |
speechdash_update_document | PUT /v1/documents/{document_id} |
speechdash_translate_document | POST /v1/documents/{document_id}/translate |
speechdash_export_document | GET /v1/documents/{document_id}/export |
speechdash_delete_document | DELETE /v1/documents/{document_id} |
speechdash_list_voices | GET /v1/voices |
speechdash_get_voice | GET /v1/voices/{voice_id} |
speechdash_synthesize_speech | POST /v1/audio/speech |
리소스: speechdash://openapi (실시간 OpenAPI JSON).
스트리밍 음성 (POST /v1/audio/stream 및 POST /v1/audio/stream/with-timestamps)에는 MCP 도구가 없습니다. 이러한 경로와 /health는 REST를 사용하세요.
크레딧
음성 합성 (REST 및 MCP)은 0.5 크레딧을 30초당 생성된 오디오에 지불합니다. 번역은 MP3 내보내기와 같은 비율로 크레딧을 사용합니다. 문서 생성 및 파일 내보내는 것은 크레딧을 사용하지 않습니다. 문서 생성은 일일 문서 한도 내에 포함됩니다.
크레딧 사용 방법을 참조하세요.