Typecast Ruby SDK

Official Ruby SDK for the Typecast Text-to-Speech API.

Installation

gem install typecast-ruby

For local development from this monorepo:

gem "typecast-ruby", path: "../typecast-ruby"

Quick Start

require "typecast"

client = Typecast::Client.new(api_key: ENV["TYPECAST_API_KEY"])
response = client.text_to_speech(
  Typecast::Models::TTSRequest.new(
    voice_id: "tc_60e5426de8b95f1d3000d7b5",
    text: "Hello from Typecast Ruby.",
    model: Typecast::Models::TTS_MODEL_V30,
    language: "eng",
    output: Typecast::Models::Output.new(audio_format: "wav")
  )
)

File.binwrite("hello.wav", response.audio_data)

Features

• Text-to-speech synthesis
• Streaming synthesis
• Word and character timestamps with SRT/VTT helpers
• Voice listing and subscription APIs
• Instant voice cloning
• No runtime dependencies beyond the Ruby standard library

Testing

make install
make test
TYPECAST_API_KEY=... make e2e