Typecast SDK

Official SDKs for the Typecast Text-to-Speech API

Transform text into natural, expressive speech with Typecast AI

Overview

This monorepo contains official SDK clients for the Typecast Text-to-Speech API across multiple programming languages. Each SDK provides a simple, idiomatic interface to convert text into high-quality AI-generated speech.

Available SDKs

Language	Package	Installation
	typecast-python	`pip install typecast-python`
	typecast-js	`npm install @neosapience/typecast-js`
	typecast-go	`go get github.com/neosapience/typecast-sdk/typecast-go`
	typecast-java	`implementation 'com.neosapience:typecast-java:1.0.0'`
	typecast-kotlin	`implementation("com.neosapience:typecast-kotlin:1.0.0")`
	typecast-csharp	`dotnet add package typecast-csharp`
	typecast-swift	Swift Package Manager
	typecast-rust	`cargo add typecast-rust`
	typecast-c	CMake
	typecast-zig	`zig fetch --save`
	typecast-php	`composer require neosapience/typecast-php`
	typecast-dart	`dart pub add typecast_dart`
	typecast-ruby	`gem install typecast-ruby`

Quick Start

1. Get Your API Key

2. Install Your Preferred SDK

Choose the SDK for your language and follow the installation instructions in its README.

3. Generate Speech

# Python Example
from typecast import TypecastClient

client = TypecastClient(api_key="your-api-key")
audio = client.tts.speak(
    text="Hello, world!",
    actor_id="YOUR_ACTOR_ID"
)
audio.save("output.wav")

// JavaScript/TypeScript Example
import { TypecastClient } from "@typecast-ai/typecast";

const client = new TypecastClient({ apiKey: "your-api-key" });
const audio = await client.tts.speak({
  text: "Hello, world!",
  actorId: "YOUR_ACTOR_ID",
});

Features

High-Quality Voices — Natural, expressive AI voices in multiple languages
Emotion Control — Fine-tune speech with emotion presets and parameters
Multiple Formats — Export as WAV, MP3, and more
Streaming Support — Real-time audio streaming for low-latency applications
Word/Character Timestamps — Alignment data + SRT/VTT export for subtitles, karaoke, and per-character highlighting
Instant cloning — Upload a short audio sample, get a custom voice ID, and synthesize with it in one flow
Simple Integration — Clean, idiomatic APIs for each language

Documentation

For detailed API documentation and guides, visit typecast.ai/docs

License

Each SDK is licensed under either the MIT License or Apache License 2.0. The specific license for each SDK can be found in the LICENSE file within each SDK directory.

SDK	License
typecast-python	Apache 2.0
typecast-js	Apache 2.0
typecast-go	MIT
typecast-java	MIT
typecast-kotlin	Apache 2.0
typecast-csharp	Apache 2.0
typecast-swift	Apache 2.0
typecast-rust	MIT
typecast-c	MIT
typecast-zig	MIT
typecast-php	MIT
typecast-dart	MIT
typecast-ruby	MIT

Third-Party Licenses

This project uses third-party libraries across different SDK implementations. We are committed to transparency and proper attribution of all dependencies.

The complete list of third-party licenses is documented in THIRD-PARTY-LICENSES.txt.

Updating Third-Party Licenses

To regenerate the third-party license file after dependency changes:

./scripts/update-third-party-licenses.sh

This script automatically collects license information from all SDK implementations using language-specific tools (pip-licenses, license-checker, cargo-license, etc.).

Made with ❤️ by Typecast AI

Code Coverage

Every SDK in this monorepo targets 100% code coverage (line + function + branch where the toolchain supports branches; line + function only on Go and Swift). The exclusion policy is documented at docs/coverage-policy.md. The shared mock server used by every SDK's coverage tests lives at test-fixtures/mock-server/.

SDK	Coverage
typecast-c
typecast-csharp
typecast-go
typecast-java
typecast-js
typecast-kotlin
typecast-python
typecast-rust
typecast-swift
typecast-zig
typecast-php
typecast-dart
typecast-ruby

Click any SDK name or badge to jump to that SDK's directory. Each SDK's README documents its installation, usage, and coverage workflow.

typecast-ruby

Development