SDK를 써야 하는 이유
HTTP API를 직접 호출해도 타입캐스트 API를 사용할 수 있지만, 운영 코드에서는 SDK 사용을 권장합니다. SDK는 인증 헤더 구성, 요청/응답 타입, 에러 처리, 스트리밍 처리, 응답 파싱 같은 반복 작업을 감싸주기 때문에 직접 HTTP 호출을 구현하는 것보다 더 안전하고 빠르게 연동할 수 있습니다. 타입캐스트 API 연동 코드가 실행될 환경에 맞춰 SDK를 선택하세요. 스크립트나 프로토타입부터 시작한다면 Python으로 시작하기 쉽습니다. 운영 서비스에서는 이미 사용하는 백엔드나 앱 런타임에 맞는 SDK를 고르는 것이 좋습니다. 모든 언어 SDK에는 음성 합성과 파일 저장을 한 번에 처리하는generateToFile 또는 generate_to_file 헬퍼가 포함되어 있습니다. .mp3 또는 .wav 파일을 바로 만들고 싶을 때 사용하세요. 각 SDK 페이지에서 언어별 예시를 확인할 수 있습니다.
| SDK | 이런 경우에 사용하세요 |
|---|---|
| Python | 스크립트, 노트북, 데이터 파이프라인, 백엔드 배치 작업, 빠른 API 프로토타입을 만들 때 |
| Javascript/Typescript | Node.js 서비스, 프론트엔드 도구, 풀스택 앱, 브라우저 호환 연동을 만들 때 |
| Go | 가벼운 백엔드 서비스, CLI, 워커, 동시성이 필요한 배치 프로세스를 만들 때 |
| Rust | 타입 안정성, 예측 가능한 성능, 네이티브 오디오 처리 파이프라인이 중요할 때 |
| C#/.NET | .NET 서비스, Windows 도구, Unity 앱, Blazor 애플리케이션을 만들 때 |
| Java | JVM 백엔드, Spring 서비스, Java 중심 엔터프라이즈 코드베이스에 연동할 때 |
| Kotlin | Kotlin 중심 JVM 서비스나 Android 애플리케이션을 만들 때 |
| C/C++ | 네이티브 연동, 임베디드 지원, FFI 바인딩, 최소 런타임 오버헤드가 필요할 때 |
| Swift | iOS, macOS, watchOS, tvOS, visionOS 애플리케이션을 만들 때 |
| Zig | C 의존성 없이 명시적인 메모리 제어가 필요한 저수준 네이티브 연동을 만들 때 |
| PHP | Laravel, WordPress, PHP 서버 렌더링 백엔드에 타입캐스트를 연동할 때 |
| Dart/Flutter | Flutter 모바일, 데스크톱, 웹 애플리케이션을 만들 때 |
| Ruby | Rails 앱, Ruby 백엔드 작업, 내부 자동화 스크립트를 만들 때 |
텍스트 전처리 SDK
| SDK | 이런 경우에 사용하세요 |
|---|---|
| Autotag SDK | 전화번호, 날짜, 시간, 금액 같은 구조화된 텍스트를 TTS가 더 자연스럽게 읽도록 전처리해야 할 때 |