Documentation Index
Fetch the complete documentation index at: https://docs.supertoneapi.com/llms.txt
Use this file to discover all available pages before exploring further.
이 문서는 영어 원문을 기반으로 자동 번역되었습니다. 표현이 어색하거나 모호한 부분이 있을 수 있으니, 정확한 내용은 영어 원문을 함께 확인해 주세요.
Python SDK
pip install supertone — 동기 및 비동기 클라이언트, 병렬 자동 청크 분할.TypeScript SDK
npm add @supertone/supertone — Promise 기반, ESM/CJS, Node 및 Bun 지원.패키지 요약
| Python | TypeScript | |
|---|---|---|
| 패키지 | PyPI의 supertone | npm의 @supertone/supertone |
| 저장소 | supertone-inc/supertone-python | supertone-inc/supertone-ts |
| 언어 | Python 3.9+ | TypeScript 5+ / Node 18+ |
| 모듈 포맷 | — | ESM + CommonJS |
| 인증 | Supertone(api_key=...) | new Supertone({ apiKey: ... }) |
| 동기 API | 지원(기본) | 해당 없음 |
| 비동기 API | *_async 메서드 + async with | 모든 메서드(Promise) |
| 스트리밍 | iter_bytes() / aiter_bytes() | ReadableStream reader |
| 긴 텍스트 자동 청크 분할 | ✅ (300자, 최대 3 워커 병렬) | ✅ (300자, 순차) |
| 커스텀 재시도 | ✅ retry_config로 설정 | ✅ retryConfig로 설정 |
| HTTP 백엔드 | httpx | fetch |
SDK가 대신 처리해 주는 것
- 인증 — 생성 시 API Key를 한 번만 전달하면 모든 요청에 올바른 헤더가 적용됩니다.
- 타입 안전 enum — 언어, 모델, 출력 포맷에 사용할 수 있습니다.
- 스트리밍 — 오디오 청크를 관용적으로 반복할 수 있습니다(Python 제너레이터, TS
ReadableStream). - 긴 텍스트 자동 청크 분할 — 두 SDK 모두 300자 단위로 입력을 분할해 청크별로 TTS를 실행하고 오디오를 병합합니다. 스트리밍 변형은 청크를 투명하게 전달하므로, 소비자는 내부에서 요청이 분할되었다는 사실을 알 필요가 없습니다.
- 오류 — HTTP 상태 코드에 매핑된 타입 기반 예외/오류 클래스(
UnauthorizedErrorResponse,TooManyRequestsErrorResponse등)를 제공합니다. - 재시도 정책 — 일시적인
5xx및429응답에 대해 백오프와 함께 설정 가능한 재시도를 지원합니다.
REST API를 직접 사용해야 할 때
REST API는 SDK가 공개되지 않은 언어와 런타임(Go, Java, PHP, Rust, 임베디드 시스템 등)에서 사용할 수 있으며, 와이어 포맷을 최대한 직접 제어하고 싶을 때도 사용할 수 있습니다. 엔드포인트는 API 레퍼런스에 문서화되어 있으며, 해당 섹션의 예제에는curl, JavaScript, Go, Python, PHP, Java가 포함되어 있습니다.
REST를 직접 호출하는 경우, 청크 분할, 재시도, 스트리밍 소비를 직접 구현해야 합니다.
다음
Python SDK
설치하고 인증한 뒤 첫 호출을 실행해 보세요.
TypeScript SDK
설치하고 인증한 뒤 첫 호출을 실행해 보세요.