Voices

import com.kugelaudio.sdk.Voice;
import com.kugelaudio.sdk.VoiceListResponse;

// List all available voices (returns VoiceListResponse)
VoiceListResponse result = client.voices().list();

for (Voice voice : result.getVoices()) {
    System.out.println(voice.getId() + ": " + voice.getName());
    System.out.println("  Sex: " + voice.getSex());
    System.out.println("  Quality: " + voice.getQuality());
}
System.out.printf("Showing %d of %d%n", result.getVoices().size(), result.getTotal());

// Paginate (limit 10, offset 0)
VoiceListResponse page = client.voices().list(null, null, 10, 0);

// Only voices that speak German
VoiceListResponse german = client.voices().list("de", null, 100, 0);
System.out.printf("%d German voices%n", german.getTotal());

import com.kugelaudio.sdk.VoiceDetail;

VoiceDetail voice = client.voices().get(1071);
System.out.println("Voice: " + voice.getName());
System.out.println("Quality: " + voice.getQuality());

import java.nio.file.Path;
import java.util.List;

VoiceDetail myVoice = client.voices().create(
    "My Custom Voice",
    "female",
    "en", // required by this SDK signature; see note below
    List.of(Path.of("reference1.wav"), Path.of("reference2.wav"))
);
int myVoiceId = myVoice.getId();
System.out.println("Created voice: " + myVoiceId);

import java.util.Map;

VoiceDetail updated = client.voices().update(myVoiceId, Map.of(
    "name", "Updated Name"
));

client.voices().delete(myVoiceId);

import com.kugelaudio.sdk.VoiceReference;

// List references
List<VoiceReference> refs = client.voices().listReferences(myVoiceId);
for (VoiceReference ref : refs) {
    System.out.println(ref.getId() + ": " + ref.getReferenceText());
}

// Add a new reference
VoiceReference ref = client.voices().addReference(
    myVoiceId,
    Path.of("new_reference.wav"),
    "Optional transcript of the audio."
);

// Delete a reference
client.voices().deleteReference(myVoiceId, ref.getId());

client.voices().publish(myVoiceId);