Using Voices

// List all available voices
const voices = await client.voices.list();

for (const voice of voices) {
  console.log(`${voice.id}: ${voice.name}`);
  console.log(`  Category: ${voice.category}`);
  console.log(`  Languages: ${voice.supportedLanguages.join(', ')}`);
}

import com.kugelaudio.sdk.Voice;
import java.util.List;

List<Voice> voices = client.voices().list();
for (Voice voice : voices) {
    System.out.printf("%d: %s%n", voice.getId(), voice.getName());
    System.out.printf("  Category: %s%n", voice.getCategory());
    System.out.printf("  Languages: %s%n",
        String.join(", ", voice.getSupportedLanguages()));
}

curl https://api.kugelaudio.com/v1/voices \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY"

// Filter by language
const germanVoices = await client.voices.list({ language: 'de' });

// Get only public voices
const publicVoices = await client.voices.list({ includePublic: true });

// Limit results
const first10 = await client.voices.list({ limit: 10 });

// Filter by language
List<Voice> germanVoices = client.voices().list("de");

// Limit results
List<Voice> first10 = client.voices().list(null, 10, null, null);

# Filter by language
curl "https://api.kugelaudio.com/v1/voices?language=de" \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY"

# Get only public voices
curl "https://api.kugelaudio.com/v1/voices?include_public=true" \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY"

# Limit results
curl "https://api.kugelaudio.com/v1/voices?limit=10" \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY"

# Get only cloned voices
curl "https://api.kugelaudio.com/v1/voices?category=cloned" \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY"

const voice = await client.voices.get(123);
console.log(`Voice: ${voice.name}`);
console.log(`Description: ${voice.description}`);
console.log(`Sample text: ${voice.sampleText}`);

Voice voice = client.voices().get(123);
System.out.printf("Voice: %s%n", voice.getName());
System.out.printf("Description: %s%n", voice.getDescription());
System.out.printf("Sample text: %s%n", voice.getSampleText());

curl https://api.kugelaudio.com/v1/voices/123 \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY"

const audio = await client.tts.generate({
  text: 'Hello with a specific voice!',
  modelId: 'kugel-1-turbo',
  voiceId: 123,
});

AudioResponse audio = client.tts().generate(
    GenerateRequest.builder("Hello with a specific voice!")
        .modelId("kugel-1-turbo")
        .voiceId(123)
        .language("en")
        .build()
);

curl -X POST https://api.kugelaudio.com/v1/tts/generate \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello with a specific voice!",
    "model_id": "kugel-1-turbo",
    "voice_id": 123
  }' \
  --output output.pcm

// With streaming
await client.tts.stream(
  { text: 'Streaming with a specific voice.', modelId: 'kugel-1-turbo', voiceId: 123 },
  { onChunk: (chunk) => playAudio(chunk.audio) }
);

// With streaming
client.tts().stream(
    GenerateRequest.builder("Streaming with a specific voice.")
        .modelId("kugel-1-turbo")
        .voiceId(123)
        .language("en")
        .build(),
    new StreamCallbacks() {
        @Override
        public void onChunk(AudioChunk chunk) {
            playAudio(chunk.getAudio());
        }
    }
);

// With streaming sessions (for LLM integration)
try (StreamingSession session = client.tts().streamingSession(
        StreamConfig.builder().voiceId(123).cfgScale(2.0).build())) {
    session.send("Hello!", true);
}

# Stream with a specific voice and pipe to ffplay
curl -X POST https://api.kugelaudio.com/v1/tts/generate \
  -H "Authorization: Bearer $KUGELAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Streaming with a specific voice.",
    "model_id": "kugel-1-turbo",
    "voice_id": 123
  }' \
  --no-buffer | ffplay -f s16le -ar 24000 -ac 1 -nodisp -