Java SDK Quickstart

dependencies {
    implementation 'ai.camb:cambai-java-sdk:0.0.1'
}

<dependency>
    <groupId>ai.camb</groupId>
    <artifactId>cambai-java-sdk</artifactId>
    <version>0.0.1</version>
</dependency>

export CAMB_API_KEY=your_api_key_here

import CambApiClient;
import resources.texttospeech.requests.CreateStreamTtsRequestPayload;
import resources.texttospeech.types.CreateStreamTtsRequestPayloadLanguage;
import resources.texttospeech.types.CreateStreamTtsRequestPayloadSpeechModel;
import java.io.InputStream;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.StandardCopyOption;

public class Main {
    public static void main(String[] args) throws Exception {
        // Initialize the client
        CambApiClient client = CambApiClient.builder()
            .apiKey(System.getenv("CAMB_API_KEY"))
            .build();

        // Stream TTS audio
        InputStream audioStream = client.textToSpeech().tts(CreateStreamTtsRequestPayload.builder()
            .text("Hello! Welcome to Camb.ai text-to-speech.")
            .voiceId(147320)
            .language(CreateStreamTtsRequestPayloadLanguage.EN_US)
            .speechModel(CreateStreamTtsRequestPayloadSpeechModel.MARS_FLASH)
            .build());

        // Save to file
        File outputFile = new File("output.wav");
        Files.copy(audioStream, outputFile.toPath(), StandardCopyOption.REPLACE_EXISTING);

        System.out.println("Success! Audio saved to output.wav");
    }
}

import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.StandardCopyOption;

public static void saveStreamToFile(InputStream stream, String filename) throws IOException {
    Files.copy(stream, Path.of(filename), StandardCopyOption.REPLACE_EXISTING);
}

// Usage:
InputStream stream = client.textToSpeech().tts(payload);
saveStreamToFile(stream, "output.wav");

.speechModel(CreateStreamTtsRequestPayloadSpeechModel.MARS_FLASH)

.speechModel(CreateStreamTtsRequestPayloadSpeechModel.MARS_PRO)

.speechModel(CreateStreamTtsRequestPayloadSpeechModel.MARS_INSTRUCT)
.userInstructions("Speak in a warm, friendly tone")

var voices = client.voiceCloning().listVoices();

for (var voice : voices) {
    System.out.println("ID: " + voice.getId() + ", Name: " + voice.getVoiceName());
}

// English (US)
.language(CreateStreamTtsRequestPayloadLanguage.EN_US)

// Spanish
.language(CreateStreamTtsRequestPayloadLanguage.ES_ES)

// French
.language(CreateStreamTtsRequestPayloadLanguage.FR_FR)

try {
    InputStream stream = client.textToSpeech().tts(payload);
} catch (Exception e) {
    System.err.println("Error generating speech: " + e.getMessage());
}

import providers.BasetenProvider;

ITtsProvider ttsProvider = new BasetenProvider(
    "YOUR_BASETEN_API_KEY",
    "YOUR_BASETEN_URL"
);