> ## Documentation Index
> Fetch the complete documentation index at: https://typecast.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK 가이드

## SDK를 써야 하는 이유

HTTP API를 직접 호출해도 타입캐스트 API를 사용할 수 있지만, 운영 코드에서는 SDK 사용을 권장합니다. SDK는 인증 헤더 구성, 요청/응답 타입, 에러 처리, 스트리밍 처리, 응답 파싱 같은 반복 작업을 감싸주기 때문에 직접 HTTP 호출을 구현하는 것보다 더 안전하고 빠르게 연동할 수 있습니다. 또한 **보이스 추천**, **텍스트 쉼 표현**, **다중 화자 합성**처럼 Direct API만으로 직접 구현하기 번거로운 고수준 워크플로우를 편리하게 제공합니다.

타입캐스트 API 연동 코드가 실행될 환경에 맞춰 SDK를 선택하세요. 스크립트나 프로토타입부터 시작한다면 Python으로 시작하기 쉽습니다. 운영 서비스에서는 이미 사용하는 백엔드나 앱 런타임에 맞는 SDK를 고르는 것이 좋습니다.

| SDK | 이런 경우에 사용하세요 |
| --- | --- |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="python" size={18} /><DocsLink href="/ko/sdk/python">Python</DocsLink></span> | 스크립트, 노트북, 데이터 파이프라인, 백엔드 배치 작업, 빠른 API 프로토타입을 만들 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="js" size={18} /><DocsLink href="/ko/sdk/javascript">Javascript/Typescript</DocsLink></span> | Node.js 서비스, 프론트엔드 도구, 풀스택 앱, 브라우저 호환 연동을 만들 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="golang" size={18} /><DocsLink href="/ko/sdk/go">Go</DocsLink></span> | 가벼운 백엔드 서비스, CLI, 워커, 동시성이 필요한 배치 프로세스를 만들 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="rust" size={18} /><DocsLink href="/ko/sdk/rust">Rust</DocsLink></span> | 타입 안정성, 예측 가능한 성능, 네이티브 오디오 처리 파이프라인이 중요할 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="microsoft" size={18} /><DocsLink href="/ko/sdk/csharp">C#/.NET</DocsLink></span> | .NET 서비스, Windows 도구, Unity 앱, Blazor 애플리케이션을 만들 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="java" size={18} /><DocsLink href="/ko/sdk/java">Java</DocsLink></span> | JVM 백엔드, Spring 서비스, Java 중심 엔터프라이즈 코드베이스에 연동할 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="k" size={18} /><DocsLink href="/ko/sdk/kotlin">Kotlin</DocsLink></span> | Kotlin 중심 JVM 서비스나 Android 애플리케이션을 만들 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="c" size={18} /><DocsLink href="/ko/sdk/c">C/C++</DocsLink></span> | 네이티브 연동, 임베디드 지원, FFI 바인딩, 최소 런타임 오버헤드가 필요할 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="swift" size={18} /><DocsLink href="/ko/sdk/swift">Swift</DocsLink></span> | iOS, macOS, watchOS, tvOS, visionOS 애플리케이션을 만들 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="zig" size={18} /><DocsLink href="/ko/sdk/zig">Zig</DocsLink></span> | C 의존성 없이 명시적인 메모리 제어가 필요한 저수준 네이티브 연동을 만들 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="php" size={18} /><DocsLink href="/ko/sdk/php">PHP</DocsLink></span> | Laravel, WordPress, PHP 서버 렌더링 백엔드에 타입캐스트를 연동할 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="dart" size={18} /><DocsLink href="/ko/sdk/dart">Dart/Flutter</DocsLink></span> | Flutter 모바일, 데스크톱, 웹 애플리케이션을 만들 때 |
| <span style={{ display: "inline-flex", alignItems: "center", gap: "8px" }}><Icon name="ruby" size={18} /><DocsLink href="/ko/sdk/ruby">Ruby</DocsLink></span> | Rails 앱, Ruby 백엔드 작업, 내부 자동화 스크립트를 만들 때 |

## Utility SDK

| SDK | 이런 경우에 사용하세요 |
| --- | --- |
| [Autotag SDK](/ko/bestpractice/autotag) | 전화번호, 날짜, 시간, 금액 같은 구조화된 텍스트를 TTS가 더 자연스럽게 읽도록 전처리해야 할 때 |