1단계 1
API 키 생성하기
앱에서 설정 → API로 이동해 키를 생성하고, 한 번 복사한 후 서버에만 보관하세요.
듣기 기능을 필요로 하는 제품 팀을 위한 API
앱과 동일한 목소리
앱의 음성 프리셋(Sophie 또는 Nathan 등)을 간단한 REST API로 동일하게 사용하세요. 배포하는 콘텐츠는 Speechdash에서 청취자들이 듣는 음성과 동일합니다.
라이브러리에 문서 저장
API를 통해 생성된 콘텐츠는 Speechdash 라이브러리에 자동 저장되어 듣기, 편집, 내보내기가 가능합니다. 앱에서 완료된 받아쓰기도 그곳에 나타납니다(source=transcription).
공식 MCP 서버
ChatGPT에 OAuth로 Speechdash를 추가하거나, API 키로 Cursor와 Claude Desktop을 연결하세요. 도구는 계정, 문서, 번역, 내보내기, 음성, 음성 합성을 지원합니다. 스트리밍은 REST를 사용하며, 설정 방법은 /agents를 참고하세요.
OpenAPI 계약
api.speechdash.com에서 공개된 OpenAPI 문서를 기반으로 클라이언트를 생성하세요. 명확한 오류 처리, 요청 ID, 그리고 rate-limit 헤더를 제공합니다.
안전한 재시도와 공정한 청구
생성 및 음성 생성 시 선택적으로 Idempotency-Key를 사용할 수 있습니다. 크레딧은 예상치로 보유되었다가 실제로 생성된 음성에 대해 정산됩니다.
팀에서 API를 활용하는 사례
LMS 또는 학습 플랫폼에 읽기 기능 추가
SaaS 제품 내 접근성 기능 구축
제품 내 spoken 미리보기 생성
내부 도구용 문서 가져오기 및 듣기 자동화
키 발급부터 첫 음성 생성까지 몇 분 안에
Public API 사용 방법
2단계 2
각 요청 인증하기
인증 헤더 `Authorization: Bearer sh_live_…`을 전송하세요. `GET /v1/me`로 키를 테스트하세요(이메일, 플랜, 잔액 확인). 유효하지 않은 키는 401 응답을 반환합니다.
3단계 3
문서 또는 음성 생성하기
라이브러리에 문서를 POST로 추가하고, 번역하거나 내보내며, 음성 합성을 음성 및 언어 제어와 함께 진행하세요. 사용량은 크레딧 사용량에 표시됩니다.