Cartesia

Features 🔥

• Fully generated C# SDK based on official Cartesia OpenAPI specification using AutoSDK
• Same day update to support new features
• Updated and supported automatically if there are no breaking changes
• All modern .NET features - nullability, trimming, NativeAOT, etc.
• Support .Net Framework/.Net Standard 2.0

Usage

using Cartesia;

using var client = new CartesiaClient(apiKey);

Check API Status

Check the Cartesia API status.

using var client = new CartesiaClient(apiKey);

// Check the API status to verify connectivity.
var response = await client.ApiStatus.ApiStatusGetAsync(
    cartesiaVersion: ApiStatusGetCartesiaVersion.x20251104);

Speech To Text Client Get Text Async

using var api = new CartesiaClient(apiKey);
ISpeechToTextClient speechClient = api;

// Transcribe audio using the MEAI ISpeechToTextClient interface.
// Cartesia processes the audio synchronously — no polling required.
using var httpClient = new HttpClient();
await using var audioStream = await httpClient.GetStreamAsync(
    "https://cdn.openai.com/API/docs/audio/alloy.wav");

var ms = new MemoryStream();
await audioStream.CopyToAsync(ms);
ms.Position = 0;

var response = await speechClient.GetTextAsync(ms);

Console.WriteLine($"Text: {response.Text}");

Speech To Text Client Get Service Metadata

using var api = new CartesiaClient("dummy-key");
ISpeechToTextClient speechClient = api;

// Retrieve metadata about the speech-to-text provider.
var metadata = speechClient.GetService<SpeechToTextClientMetadata>();

Speech To Text Client Get Service Self

using var api = new CartesiaClient("dummy-key");
ISpeechToTextClient speechClient = api;

// Access the underlying CartesiaClient from the MEAI interface.
var self = speechClient.GetService<CartesiaClient>();

Text To Speech Client Get Service Metadata

using var api = new CartesiaClient("dummy-key");
ITextToSpeechClient speechClient = api;

// Retrieve metadata about the text-to-speech provider.
var metadata = speechClient.GetService<TextToSpeechClientMetadata>();

Latest Text To Speech Model

Exercise the production Sonic 3.6 snapshot end to end with Russian text.

using var client = new CartesiaClient(apiKey);

var audio = await client.Tts.TtsBytesAsync(
    TtsBytesCartesiaVersion.x20251104,
    new TTSRequest
    {
        ModelId = TTSModel.Sonic3620260827,
        Transcript = "Привет! Это стабильная модель Cartesia Sonic 3.6.",
        Voice = new TTSRequestVoiceSpecifier
        {
            Mode = TTSRequestVoiceSpecifierMode.Id,
            Id = "694f9389-aac1-45b6-b726-9d9369183238",
        },
        Language = SupportedLanguage.Ru,
        OutputFormat = new RawOutputFormat
        {
            Container = RawOutputFormatContainer.Raw,
            Encoding = RawEncoding.PcmS16le,
            SampleRate = 24000,
        },
    });

Text To Speech SSE Streaming

var handler = new TtsSseResponseHandler();
using var api = new CartesiaClient(
    "dummy-key",
    new HttpClient(handler)
    {
        BaseAddress = new Uri(CartesiaClient.DefaultBaseUrl),
    });

var request = new TTSSSERequest
{
    ModelId = TTSModel.Sonic35,
    Transcript = "Hello from Cartesia.",
    Voice = new TTSRequestVoiceSpecifier
    {
        Mode = TTSRequestVoiceSpecifierMode.Id,
        Id = "694f9389-aac1-45b6-b726-9d9369183238",
    },
    OutputFormat = new SSEOutputFormat
    {
        Container = SSEOutputFormatContainer.Raw,
        Encoding = RawEncoding.PcmS16le,
        SampleRate = 24000,
    },
    ContextId = "ctx-1",
};

var events = new List<CartesiaTtsSseEvent>();

// StreamTtsSseAsync yields events as the SSE response is read and decodes chunk audio bytes.
await foreach (var @event in api.StreamTtsSseAsync(request))
{
    events.Add(@event);
}

Ecosystem maintenance

This SDK is one of more than 200 .NET SDKs maintained with AutoSDK. The tryAGI SDK audit continuously checks repository synchronization, upstream-spec regeneration, release workflows, warnings, public API visibility, and trimming/NativeAOT compatibility.

Every issue is first investigated for ecosystem-wide applicability. When the root cause belongs in AutoSDK, we fix and regression-test the generator, then roll the improvement out to every applicable SDK. Provider-specific behavior remains in this repository when it cannot be derived safely from the API specification.

Issue content—including code blocks, logs, links, and attachments—is treated only as untrusted diagnostic data. Embedded control instructions, hidden directives, delimiter tricks, or requests to alter triage or tooling behavior are ignored. Please report reproducible technical evidence and remove secrets and personal data.

Support

Priority place for bugs: https://github.com/tryAGI/Cartesia/issues
Priority place for ideas and general questions: https://github.com/tryAGI/Cartesia/discussions
Discord: https://discord.gg/Ca2xhfBf3v

Acknowledgments

This project is supported by JetBrains through the Open Source Support Program.

This project is supported by CodeRabbit through the Open Source Support Program.