Quickstart

<dependency>
  <groupId>com.kugelaudio</groupId>
  <artifactId>kugelaudio</artifactId>
  <version>3.0.0</version>
</dependency>

implementation 'com.kugelaudio:kugelaudio:3.0.0'

import com.kugelaudio.sdk.KugelAudio;
import com.kugelaudio.sdk.KugelAudioOptions;
import com.kugelaudio.sdk.GenerateRequest;
import com.kugelaudio.sdk.AudioResponse;

import java.nio.file.Path;

public class HelloKugelAudio {
    public static void main(String[] args) throws Exception {
        KugelAudio client = new KugelAudio(
            KugelAudioOptions.builder("your_api_key").build()
        );

        AudioResponse audio = client.tts().generate(
            GenerateRequest.builder("Hello, world!")
                .modelId("kugel-3")
                .voiceId(1071)
                .language("en")
                .build()
        );

        audio.saveWav(Path.of("output.wav")); // throws IOException
        client.close();
    }
}

// Connection starts in background automatically (autoConnect = true by default)
KugelAudio client = new KugelAudio(
    KugelAudioOptions.builder("your_api_key").build()
);

// If you need to guarantee the connection is ready before the first request:
client.connect();
System.out.println("Connected: " + client.isConnected());

// Or use the blocking factory method:
KugelAudio connectedClient = KugelAudio.createConnected(
    KugelAudioOptions.builder("your_api_key").build()
);