CSharp SDK Quickstart

dotnet add package CambApi

export CAMB_API_KEY=your_api_key_here

using CambApi;

// Initialize the client
var client = new CambApiClient(Environment.GetEnvironmentVariable("CAMB_API_KEY"));

// Stream TTS audio
var responseStream = await client.TextToSpeech.TtsAsync(new CreateStreamTtsRequestPayload
{
    Text = "Hello! Welcome to Camb.ai text-to-speech.",
    Language = CreateStreamTtsRequestPayloadLanguage.EnUs,
    VoiceId = 147320,
    SpeechModel = CreateStreamTtsRequestPayloadSpeechModel.MarsFlash,
    OutputConfiguration = new StreamTtsOutputConfiguration
    {
        Format = OutputFormat.Wav
    }
});

// Save to file
using var fileStream = File.Create("output.wav");
await responseStream.CopyToAsync(fileStream);

Console.WriteLine("Success! Audio saved to output.wav");

public static async Task SaveStreamToFileAsync(Stream stream, string filename)
{
    using var fileStream = File.Create(filename);
    await stream.CopyToAsync(fileStream);
}

// Usage:
var stream = await client.TextToSpeech.TtsAsync(payload);
await SaveStreamToFileAsync(stream, "output.wav");

SpeechModel = CreateStreamTtsRequestPayloadSpeechModel.MarsFlash

SpeechModel = CreateStreamTtsRequestPayloadSpeechModel.MarsPro

SpeechModel = CreateStreamTtsRequestPayloadSpeechModel.MarsInstruct,
UserInstructions = "Speak in a warm, friendly tone"

var voices = await client.VoiceCloning.ListVoicesAsync();

foreach (var voice in voices)
{
    Console.WriteLine($"ID: {voice.Id}, Name: {voice.VoiceName}, Gender: {voice.Gender}");
}

// English (US)
Language = CreateStreamTtsRequestPayloadLanguage.EnUs

// Spanish
Language = CreateStreamTtsRequestPayloadLanguage.EsEs

// French
Language = CreateStreamTtsRequestPayloadLanguage.FrFr

try 
{
    var stream = await client.TextToSpeech.TtsAsync(payload);
}
catch (Exception ex)
{
    Console.WriteLine($"Error generating speech: {ex.Message}");
}

using CambApi.Providers;

var ttsProvider = new BasetenProvider(
    apiKey: "YOUR_BASETEN_API_KEY",
    url: "YOUR_BASETEN_URL"
);