Speechdash 공개 API가 시작되었습니다

Speechdash 공개 API가 이제 api.speechdash.com/v1에서 사용 가능합니다. 사람들이 텍스트를 듣는 제품을 만들고 있다면, 브라우저 UI를 열지 않고도 문서를 생성하고 음성을 만들 수 있습니다.

이 글에서는 어떤 기능이 제공되는지, 결제 방식, 그리고 몇 분 안에 첫 요청을 보내는 방법을 다룹니다.

오늘의 API 기능

REST API는 앱에서 이미 알고 있는 리스닝 스택을 그대로 반영합니다:

• 사용자의 Speechdash 라이브러리에서 문서 생성 및 관리 (제목과 언어가 포함된 텍스트 임포트)
• 다양한 언어에서 Narrator, Questioner, Expert 음성 프리셋으로 음성 생성
• 예측 가능한 JSON 엔드포인트를 통해 문서 목록 조회, 읽기, 업데이트, 삭제

API를 통해 생성된 문서는 speechdash.com에서 라이브러리에 표시됩니다. 사용자는 앱에서 계속 듣거나, 텍스트를 편집하고, 오디오를 내보내거나, 다른 기기에서 이어서 작업할 수 있습니다.

음성 합성은 앱 내 재생에 사용되는 동일한 클라우드 음성을 사용합니다. 사용량은 계정의 크레딧 지갑에서 차감되며, 제품 내 클라우드 리스닝과 동일한 규칙이 적용됩니다.

대상 사용자

API는 리스닝 기능이 다른 제품 내에 포함되어야 할 때 팀에서 사용합니다:

• 과제나 기사에 읽기 기능을 추가하고자 하는 LMS 및 학습 플랫폼
• SaaS 도구 내 접근성 레이어
• 콘텐츠를 일괄 임포트하여 청각적으로 검토해야 하는 내부 도구
• 완전한 UI를 구축하기 전에 음성 미리보기가 필요한 프로토타입

사용자가 이미 Speechdash 계정을 보유하고 있다면, 하나의 지갑과 하나의 문서 라이브러리를 그대로 사용할 수 있습니다. API는 별도의 제품이 아니라 추가적인 입구 역할을 합니다.

인증 및 문서

각 계정은 앱의 설정 → API에서 API 키를 생성할 수 있습니다. 키는 한 번만 표시되며, 접두사만 서버 측에 저장됩니다.

모든 요청에 Authorization: Bearer sh_live_… 헤더를 포함하세요. 유효하지 않거나 취소된 키는 401 응답을 반환합니다.

개발자 문서는 헬프 센터에서 확인할 수 있습니다:

• API 개요 (인증, 제한, 결제, 멱등성)
• 실시간 OpenAPI 계약: api.speechdash.com/v1/openapi.json

마케팅 기능 페이지 공개 API에서는 팀 내 비개발자도 이해할 수 있도록 스토리를 요약합니다.

결제 개요

음성 요청은 예상치를 보유한 후 측정된duration으로 정산됩니다. 재시도는 문서 생성 및 음성 요청 시 Idempotency-Key를 보내 네트워크 오류로 인한 이중 과금을 방지할 수 있습니다.

요율 제한은 계정당 적용됩니다(키당이 아님). 응답에는 표준 요율 제한 헤더와 백오프가 필요한 경우 Retry-After가 포함됩니다.

5분 만에 첫 요청 보내기

1. speechdash.com에 로그인하고 설정 → API를 엽니다
2. 키를 생성하고 즉시 복사합니다
3. API 개요를 읽습니다
4. /v1/documents로 짧은 텍스트를 POST하거나, 음성 프리셋과 언어를 지정하여 /v1/audio/speech를 호출합니다

전체 장을 스트리밍하기 전에 두 문장짜리 샘플로 시작하세요. 개요 문서에 정확한 필드와 예제 응답이 나와 있습니다.

다음 단계

제품 요구 사항이 커짐에 따라 API도 확장될 예정입니다. 오늘 통합한다면 Discord에서 초기 피드백을 공유하거나, 계약서의 내용이 unclear하다면 헬프 센터를 열어주세요.

Speechdash와 함께 구축해주셔서 감사합니다. 여러분이 어떤 것을 만들어낼지 기대가 됩니다.

관련 가이드

• 공개 API 기능 페이지
• Speechdash 시작하기
• 클라우드 재생
• 임포트 형식
• 어떤 기능이 크레딧을 사용하나요