Java

import com.neosapience.TypecastClient;
import com.neosapience.models.*;

import java.io.FileOutputStream;

public class QuickStart {
    public static void main(String[] args) throws Exception {
        // 클라이언트 초기화
        TypecastClient client = new TypecastClient("YOUR_API_KEY");

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

        TTSResponse response = client.textToSpeech(request);

        // 오디오 파일 저장
        try (FileOutputStream fos = new FileOutputStream("output." + response.getFormat())) {
            fos.write(response.getAudioData());
        }

        System.out.println("Audio saved! Duration: " + response.getDuration() + "s, Format: " + response.getFormat());

        // 정리
        client.close();
    }
}

// 환경 변수 사용
// export TYPECAST_API_KEY="your-api-key-here"
TypecastClient client = new TypecastClient();

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

// 또는 사용자 정의 base URL과 함께
TypecastClient client = new TypecastClient("your-api-key-here", "https://custom-api.example.com");

TYPECAST_API_KEY=your-api-key-here

TTSRequest request = TTSRequest.builder()
        .voiceId("tc_672c5f5ce59fac2a48faeaee")
        .text("사용자 정의 오디오 출력!")
        .model(TTSModel.SSFM_V30)
        .output(Output.builder()
                .targetLufs(-14.0)                 // 범위: -70 ~ 0 (LUFS)
                .audioPitch(2)                  // 범위: -12 to +12 반음
                .audioTempo(1.2)                // 범위: 0.5x to 2.0x
                .audioFormat(AudioFormat.MP3)   // 옵션: WAV, MP3
                .build())
        .seed(42)  // 0 이상의 정수 시드 (재현 가능한 결과)
        .build();

TTSResponse response = client.textToSpeech(request);

try (FileOutputStream fos = new FileOutputStream("output." + response.getFormat())) {
    fos.write(response.getAudioData());
}
System.out.println("Duration: " + response.getDuration() + "s, Format: " + response.getFormat());

// 모든 음성 가져오기
List<VoiceV2Response> voices = client.getVoicesV2();

// 기준으로 필터링
VoicesV2Filter filter = VoicesV2Filter.builder()
        .model(TTSModel.SSFM_V30)
        .gender(GenderEnum.FEMALE)
        .age(AgeEnum.YOUNG_ADULT)
        .build();

List<VoiceV2Response> filtered = client.getVoicesV2(filter);

// 음성 정보 표시
for (VoiceV2Response voice : voices) {
    System.out.println("ID: " + voice.getVoiceId() + ", Name: " + voice.getVoiceName());
    System.out.println("Gender: " + voice.getGender() + ", Age: " + voice.getAge());

    for (ModelInfo model : voice.getModels()) {
        System.out.println("Model: " + model.getVersion() + ", Emotions: " + model.getEmotions());
    }

    if (voice.getUseCases() != null) {
        System.out.println("Use cases: " + String.join(", ", voice.getUseCases()));
    }
}

import javax.sound.sampled.*;

// 오디오 재생 설정: 32000 Hz, 16비트, 모노, 리틀엔디안
AudioFormat format = new AudioFormat(32000, 16, 1, true, false);
SourceDataLine line = AudioSystem.getSourceDataLine(format);
line.open(format, 8192);
line.start();

try (InputStream stream = client.textToSpeechStream(request)) {
    byte[] buf = new byte[4096];
    boolean first = true;
    int bytesRead;

    while ((bytesRead = stream.read(buf)) != -1) {
        int offset = 0;
        if (first) {
            offset = 44;           // 44바이트 WAV 헤더 건너뛰기
            bytesRead -= 44;
            first = false;
        }
        line.write(buf, offset, bytesRead);
    }
}
line.drain();
line.close();
client.close();

import com.neosapience.TypecastClient;
import com.neosapience.exceptions.*;

try {
    TTSResponse response = client.textToSpeech(request);
} catch (UnauthorizedException e) {
    // 401: 잘못된 API 키
    System.err.println("Invalid API key: " + e.getMessage());
} catch (PaymentRequiredException e) {
    // 402: 크레딧 부족
    System.err.println("Insufficient credits: " + e.getMessage());
} catch (ForbiddenException e) {
    // 403: 접근 거부
    System.err.println("Access denied: " + e.getMessage());
} catch (NotFoundException e) {
    // 404: 리소스를 찾을 수 없음
    System.err.println("Voice not found: " + e.getMessage());
} catch (UnprocessableEntityException e) {
    // 422: 유효성 검사 오류
    System.err.println("Validation error: " + e.getMessage());
} catch (RateLimitException e) {
    // 429: 요청 한도 초과
    System.err.println("Rate limit exceeded - please try again later");
} catch (InternalServerException e) {
    // 500: 서버 오류
    System.err.println("Server error: " + e.getMessage());
} catch (TypecastException e) {
    // 일반 오류
    System.err.println("API error (" + e.getStatusCode() + "): " + e.getMessage());
}