C#/.NET

using Typecast;
using Typecast.Models;

// 클라이언트 초기화
using var client = new TypecastClient("YOUR_API_KEY");

// 텍스트를 음성으로 변환
var request = new TTSRequest(
    text: "안녕하세요! 저는 텍스트 음성 변환 에이전트입니다.",
    voiceId: "tc_672c5f5ce59fac2a48faeaee",
    model: TTSModel.SsfmV30
);

var response = await client.TextToSpeechAsync(request);

// 오디오 파일 저장
await response.SaveToFileAsync("output.wav");
Console.WriteLine(quot;Audio saved! Duration: {response.Duration}s, Format: {response.Format}");

var voices = await client.RecommendVoicesAsync(
    "warm female voice for a product tutorial",
    count: 3
);

foreach (var voice in voices)
{
    Console.WriteLine(quot;{voice.VoiceId} {voice.VoiceName} {voice.Score}");
}

// 환경 변수 사용 (TYPECAST_API_KEY)
using var client = new TypecastClient();

// 또는 직접 전달
using var client = new TypecastClient("your-api-key-here");

// 또는 구성 객체 사용
var config = new TypecastClientConfig
{
    ApiKey = "your-api-key-here",
    TimeoutSeconds = 60  // 선택 사항, 기본값: 30
};
using var client = new TypecastClient(config);

var config = new TypecastClientConfig
{
    ApiHost = "https://your-proxy.example.com"
};
using var client = new TypecastClient(config);

var request = new TTSRequest("사용자 정의 오디오 출력!", voiceId, TTSModel.SsfmV30)
{
    Language = LanguageCode.Korean,
    Output = new Output(
        targetLufs: -14.0,          // 범위: -70 ~ 0 (LUFS)
        audioPitch: 2,            // 범위: -12 to +12 반음
        audioTempo: 1.2,          // 범위: 0.5x to 2.0x
        audioFormat: AudioFormat.Mp3  // 옵션: Wav, Mp3
    ),
    Seed = 42  // 재현 가능한 결과를 위해
};

var response = await client.TextToSpeechAsync(request);
await response.SaveToFileAsync(quot;output{response.FileExtension}");
Console.WriteLine(quot;Duration: {response.Duration}s, Format: {response.Format}");

await client.GenerateToFileAsync("output.mp3", new GenerateToFileRequest
{
    Text = "안녕하세요, 타입캐스트입니다.",
    VoiceId = "tc_672c5f5ce59fac2a48faeaee" // voice_id는 https://studio.typecast.ai/developers/api/voices 에서 확인하세요.
});

var audio = await client.ComposeSpeech()
    .Defaults(new ComposerSettings { VoiceId = "tc_672c5f5ce59fac2a48faeaee", Model = TTSModel.SsfmV30 })
    .Say("안녕하세요<|5s|>반갑습니다<|1s|>오늘<|2s|>날씨는 어떤 것 같으세요?")
    .GenerateAsync();

using Typecast;
using Typecast.Models;

using var client = new TypecastClient("YOUR_API_KEY");

var audio = await client.ComposeSpeech()
    .Defaults(new ComposerSettings { VoiceId = "tc_672c5f5ce59fac2a48faeaee", Model = TTSModel.SsfmV30 })
    .Say("Hello there")
    .Pause(5)
    .Say("Nice to meet you", new ComposerSettings { VoiceId = "tc_60e5426de8b95f1d3000d7b5", Output = new Output(audioPitch: 2) })
    .Say("Today")
    .Pause(2)
    .Say("How does the weather feel?")
    .GenerateAsync();

await audio.SaveToFileAsync("conversation.wav");

// 모든 음성 가져오기
var voices = await client.GetVoicesV2Async();

// 기준으로 필터링
var filtered = await client.GetVoicesV2Async(new VoicesV2Filter
{
    Model = TTSModel.SsfmV30,
    Gender = GenderEnum.Female,
    Age = AgeEnum.YoungAdult
});

// 음성 정보 표시
foreach (var voice in voices)
{
    Console.WriteLine(quot;ID: {voice.VoiceId}, Name: {voice.VoiceName}");
    Console.WriteLine(quot;Gender: {voice.Gender}, Age: {voice.Age}");
    Console.WriteLine(quot;Models: {string.Join(", ", voice.Models.Select(m => m.Version))}");
    Console.WriteLine(quot;Use cases: {string.Join(", ", voice.UseCases ?? new List<string>())}");
}

// 원시 PCM 추출 (44바이트 WAV 헤더 건너뛰기)
using var stream = await client.TextToSpeechStreamAsync(request);

var buffer = new byte[8192];
bool first = true;

while (true)
{
    int bytesRead = await stream.ReadAsync(buffer);
    if (bytesRead == 0) break;

    ReadOnlySpan<byte> pcm = buffer.AsSpan(0, bytesRead);
    if (first)
    {
        pcm = pcm[44..];  // WAV 헤더 건너뛰기
        first = false;
    }
    // pcm은 32000 Hz 16비트 모노 원시 PCM
    // 오디오 출력으로 전달 (예: NAudio)
}

using Typecast;
using Typecast.Models;

var client = new TypecastClient("YOUR_API_KEY");

var result = await client.TextToSpeechWithTimestampsAsync(new TTSRequestWithTimestamps {
    VoiceId = "tc_60e5426de8b95f1d3000d7b5",
    Text = "Hello. How are you?",
    Model = "ssfm-v30"
});

await File.WriteAllBytesAsync("output.wav", result.AudioBytes());
Console.WriteLine(quot;재생 시간: {result.AudioDuration:F3}초");

foreach (var word in result.Words) {
    Console.WriteLine(quot;  [{word.StartTime:F3}s – {word.EndTime:F3}s] {word.Text}");
}

// 문자 단위 정렬 - 일본어·중국어에 필수
var result = await client.TextToSpeechWithTimestampsAsync(new TTSRequestWithTimestamps {
    VoiceId = "tc_60e5426de8b95f1d3000d7b5",
    Text = "Hello. How are you?",
    Model = "ssfm-v30",
    Granularity = Granularity.Char
});

string srt = result.ToSrt();
await File.WriteAllTextAsync("output.srt", srt);

string vtt = result.ToVtt();
await File.WriteAllTextAsync("output.vtt", vtt);

using Typecast;
using Typecast.Exceptions;

try
{
    var response = await client.TextToSpeechAsync(request);
}
catch (UnauthorizedException)
{
    Console.WriteLine("Invalid or missing API key");
}
catch (PaymentRequiredException)
{
    Console.WriteLine("Insufficient credits");
}
catch (UnprocessableEntityException ex)
{
    Console.WriteLine(quot;Validation error: {ex.ResponseBody}");
}
catch (RateLimitException)
{
    Console.WriteLine("Rate limit exceeded - please try again later");
}
catch (TypecastException ex)
{
    Console.WriteLine(quot;API error ({ex.StatusCode}): {ex.Message}");
}

// 동기 텍스트 음성 변환
var response = client.TextToSpeech(request);
response.SaveToFile("output.wav");

// 동기 음성 목록
var voices = client.GetVoicesV2();
var voice = client.GetVoiceV2("voice_id");