Swift

git clone --branch typecast-swift/v0.3.10 --depth 1 https://github.com/neosapience/typecast-sdk.git

dependencies: [
    .package(path: "typecast-sdk/typecast-swift")
],
targets: [
    .target(
        name: "YourTarget",
        dependencies: [
            .product(name: "Typecast", package: "typecast-swift")
        ]
    )
]

import AVFoundation
import Typecast

let client = TypecastClient(apiKey: "YOUR_API_KEY")
var audioPlayer: AVAudioPlayer?

// 편의 메서드로 간단하게 사용
let audio = try await client.speak(
    "안녕하세요! 저는 텍스트 음성 변환 에이전트입니다.",
    voiceId: "tc_672c5f5ce59fac2a48faeaee"
)

// 데이터에서 직접 오디오 재생
audioPlayer = try AVAudioPlayer(data: audio.audioData)
audioPlayer?.play()
print("Duration: \(audio.duration)s, Format: \(audio.format.rawValue)")

let voices = try await client.recommendVoices(
    query: "warm female voice for a product tutorial",
    count: 3
)

for voice in voices {
    print("\(voice.voiceId) \(voice.voiceName) \(voice.score)")
}

import Typecast

// 직접 초기화
let client = TypecastClient(apiKey: "your-api-key")

// 사용자 정의 base URL과 함께
let client = TypecastClient(
    apiKey: "your-api-key",
    baseURL: "https://api.typecast.ai"
)

// 구성 구조체 사용
let config = TypecastConfiguration(apiKey: "your-api-key")
let client = TypecastClient(configuration: config)

let client = TypecastClient(
    baseURL: "https://your-proxy.example.com"
)

let request = TTSRequest(
    voiceId: "tc_672c5f5ce59fac2a48faeaee",
    text: "사용자 정의 오디오 출력!",
    model: .ssfmV30,
    output: OutputSettings(
        targetLufs: -14.0,     // 범위: -70 ~ 0 (LUFS)
        audioPitch: 2,        // 범위: -12 to +12 반음
        audioTempo: 1.2,      // 범위: 0.5x to 2.0x
        audioFormat: .mp3     // 옵션: .wav, .mp3
    ),
    seed: 42  // 부호 없는 정수 시드 (재현 가능한 결과)
)

let response = try await client.textToSpeech(request)

audioPlayer = try AVAudioPlayer(data: response.audioData)
audioPlayer?.play()
print("Duration: \(response.duration)s, Format: \(response.format.rawValue)")

try await client.generateToFile(
    "output.mp3",
    request: GenerateToFileRequest(
        voiceId: "tc_672c5f5ce59fac2a48faeaee", // voice_id는 https://studio.typecast.ai/developers/api/voices 에서 확인하세요.
        text: "안녕하세요, 타입캐스트입니다."
    )
)

let audio = try await client.composeSpeech()
    .defaults(ComposerSettings(voiceId: "tc_672c5f5ce59fac2a48faeaee", model: .ssfmV30))
    .say("안녕하세요<|5s|>반갑습니다<|1s|>오늘<|2s|>날씨는 어떤 것 같으세요?")
    .generate()

let audio = try await client.composeSpeech()
    .defaults(ComposerSettings(voiceId: "tc_672c5f5ce59fac2a48faeaee", model: .ssfmV30))
    .say("Hello there")
    .pause(5)
    .say("Nice to meet you", overrides: ComposerSettings(
        voiceId: "tc_60e5426de8b95f1d3000d7b5",
        output: OutputSettings(audioPitch: 2)
    ))
    .say("Today")
    .pause(2)
    .say("How does the weather feel?")
    .generate()

try audio.audioData.write(to: URL(fileURLWithPath: "conversation.wav"))

// 모든 음성 가져오기
let voices = try await client.getVoices()

// 기준으로 필터링
let filteredVoices = try await client.getVoices(filter: VoicesV2Filter(
    model: .ssfmV30,
    gender: .female,
    age: .youngAdult
))

// 특정 음성 가져오기
let voice = try await client.getVoice(voiceId: "tc_672c5f5ce59fac2a48faeaee")

// 음성 정보 표시
print("ID: \(voice.voiceId), Name: \(voice.voiceName)")
print("Gender: \(voice.gender?.rawValue ?? "N/A"), Age: \(voice.age?.rawValue ?? "N/A")")

for model in voice.models {
    print("Model: \(model.version.rawValue), Emotions: \(model.emotions.joined(separator: ", "))")
}

if let useCases = voice.useCases {
    print("Use cases: \(useCases.joined(separator: ", "))")
}

// 자동 언어 감지 (권장)
let request = TTSRequest(
    voiceId: "tc_672c5f5ce59fac2a48faeaee",
    text: "こんにちは。お元気ですか。",
    model: .ssfmV30
)

let response = try await client.textToSpeech(request)

// 또는 언어를 명시적으로 지정
let koreanRequest = TTSRequest(
    voiceId: "tc_672c5f5ce59fac2a48faeaee",
    text: "안녕하세요. 반갑습니다.",
    model: .ssfmV30,
    language: .korean  // 명시적 언어 코드
)

let koreanResponse = try await client.textToSpeech(koreanRequest)

audioPlayer = try AVAudioPlayer(data: koreanResponse.audioData)
audioPlayer?.play()

import AVFoundation
import Typecast

let engine = AVAudioEngine()
let playerNode = AVAudioPlayerNode()
let format = AVAudioFormat(commonFormat: .pcmFormatInt16, sampleRate: 32000, channels: 1, interleaved: true)!

engine.attach(playerNode)
engine.connect(playerNode, to: engine.mainMixerNode, format: format)
try engine.start()
playerNode.play()

let stream = try await client.textToSpeechStream(request)
var first = true

for try await chunk in stream {
    var pcmData = chunk
    if first {
        pcmData = chunk.dropFirst(44)  // 44바이트 WAV 헤더 건너뛰기
        first = false
    }
    let buffer = AVAudioPCMBuffer(pcmFormat: format, frameCapacity: AVAudioFrameCount(pcmData.count / 2))!
    buffer.frameLength = buffer.frameCapacity
    pcmData.withUnsafeBytes { ptr in
        buffer.int16ChannelData!.pointee.update(from: ptr.bindMemory(to: Int16.self).baseAddress!, count: Int(buffer.frameLength))
    }
    playerNode.scheduleBuffer(buffer)
}

import Typecast

let client = TypecastClient(apiKey: "YOUR_API_KEY")

let result = try await client.textToSpeechWithTimestamps(TTSRequestWithTimestamps(
    voiceId: "tc_60e5426de8b95f1d3000d7b5",
    text: "Hello. How are you?",
    model: "ssfm-v30"
))

audioPlayer = try AVAudioPlayer(data: result.audioBytes())
audioPlayer?.play()
print(String(format: "재생 시간: %.3f초", result.audioDuration))

for word in result.words {
    print(String(format: "  [%.3fs – %.3fs] %@", word.startTime, word.endTime, word.text))
}

// 문자 단위 정렬 - 일본어·중국어에 필수
let result = try await client.textToSpeechWithTimestamps(TTSRequestWithTimestamps(
    voiceId: "tc_60e5426de8b95f1d3000d7b5",
    text: "Hello. How are you?",
    model: "ssfm-v30",
    granularity: .char
))

let srt = try result.toSrt()
print(srt)

let vtt = try result.toVtt()
print(vtt)

import Typecast

do {
    let response = try await client.textToSpeech(request)
} catch let error as TypecastError {
    switch error {
    case .unauthorized(let message):
        // 401: 잘못된 API 키
        print("Invalid API key: \(message)")
    case .paymentRequired(let message):
        // 402: 크레딧 부족
        print("Insufficient credits: \(message)")
    case .notFound(let message):
        // 404: 리소스를 찾을 수 없음
        print("Voice not found: \(message)")
    case .validationError(let message):
        // 422: 유효성 검사 오류
        print("Validation error: \(message)")
    case .rateLimitExceeded(let message):
        // 429: 요청 한도 초과
        print("Rate limit exceeded: \(message)")
    case .serverError(let message):
        // 500: 서버 오류
        print("Server error: \(message)")
    case .networkError(let underlyingError):
        // 네트워크 연결 문제
        print("Network error: \(underlyingError.localizedDescription)")
    case .invalidResponse(let message):
        // 서버의 잘못된 응답
        print("Invalid response: \(message)")
    default:
        print("Error: \(error.localizedDescription)")
    }
    
    // 사용 가능한 경우 상태 코드에 액세스
    if let statusCode = error.statusCode {
        print("HTTP status: \(statusCode)")
    }
}

import Typecast
import AVFoundation

class TTSManager {
    private let client = TypecastClient(apiKey: "YOUR_API_KEY")
    private var audioPlayer: AVAudioPlayer?
    
    func speak(_ text: String) async throws {
        let audio = try await client.speak(text, voiceId: "tc_672c5f5ce59fac2a48faeaee")
        
        // 데이터에서 직접 오디오 재생
        audioPlayer = try AVAudioPlayer(data: audio.audioData)
        audioPlayer?.play()
    }
}

import Typecast
import AppKit
import AVFoundation

class MacTTSManager {
    private let client = TypecastClient(apiKey: "YOUR_API_KEY")
    private var audioPlayer: AVAudioPlayer?
    
    func speak(_ text: String) async throws {
        let audio = try await client.speak(text, voiceId: "tc_672c5f5ce59fac2a48faeaee")
        
        audioPlayer = try AVAudioPlayer(data: audio.audioData)
        audioPlayer?.play()
    }
    
}

import Typecast
import AVFoundation

class WatchTTSManager {
    private let client = TypecastClient(apiKey: "YOUR_API_KEY")
    private var audioPlayer: AVAudioPlayer?
    
    func speak(_ text: String) async throws {
        let audio = try await client.speak(text, voiceId: "tc_672c5f5ce59fac2a48faeaee")
        
        audioPlayer = try AVAudioPlayer(data: audio.audioData)
        audioPlayer?.play()
    }
}