> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Java

[![Maven Central Version](https://img.shields.io/maven-central/v/ai.sunra.client/sunra-client)](https://search.maven.org/artifact/ai.sunra.client/sunra-client)

### Einführung

Die Client-Bibliothek für Java bietet eine benutzerfreundliche Schnittstelle zur Interaktion mit den Diensten von Sunra AI.

### Installation

Um den Client in Ihr Projekt zu integrieren, fügen Sie die Abhängigkeit mit Maven oder Gradle hinzu:

<CodeGroup>
  ```kotlin Gradle theme={null}
  implementation("ai.sunra.client:sunra-client:0.1.5")
  ```

  ```xml Maven theme={null}
  <dependency>
      <groupId>ai.sunra.client</groupId>
      <artifactId>sunra-client</artifactId>
      <version>0.1.5</version>
  </dependency>
  ```
</CodeGroup>

### Funktionen

#### Endpunkte aufrufen

Sunra AI verwaltet Endpunktanfragen über ein Warteschlangensystem, das Zuverlässigkeit und Skalierbarkeit gewährleistet. Verwenden Sie die `subscribe`-Methode, um eine Anfrage zu senden und auf das Ergebnis zu warten.

**Beispiel:**

```java theme={null}
import ai.sunra.client.*;
import ai.sunra.client.queue.*;
import java.util.Map;
import com.google.gson.JsonObject;
import java.util.function.Consumer;

ClientConfig config = ClientConfig.builder()
    .withCredentials(CredentialsResolver.fromEnv())
    .build();

SunraClient client = SunraClient.withConfig(config);
Map<String, Object> input = Map.of(
    "prompt", "ein Hund, der im Park rennt");

Consumer<QueueStatus.StatusUpdate> statusUpdateHandler = update -> {
    String status = update.getStatus().toString();
    String message = String.format("\nStatus-Update: %s, Anfrage-ID: %s",
        status, update.getRequestId());
    System.out.println(message);
};

SubscribeOptions<JsonObject> options = SubscribeOptions.<JsonObject>builder()
    .input(input)
    .resultType(JsonObject.class)
    .onQueueUpdate(statusUpdateHandler)
    .logs(true)
    .build();

// die subscribe-Anfrage in einer Variablen speichern und ausgeben
Output<JsonObject> response = client.subscribe("black-forest-labs/flux-kontext-pro/text-to-image", options);
System.out.println("Abgeschlossen!");
System.out.println(response.getData());
```

#### Warteschlangenverwaltung

Verwalten Sie Ihre Anfragen mit diesen Methoden:

##### Eine Anfrage senden

Senden Sie eine Anfrage und rufen Sie die `request_id` zur späteren Verwendung ab.

**Beispiel:**

```java theme={null}
import ai.sunra.client.*;
import ai.sunra.client.queue.*;
import java.util.Map;
import com.google.gson.JsonObject;
import java.util.function.Consumer;

ClientConfig config = ClientConfig.builder()
    .withCredentials(CredentialsResolver.fromEnv())
    .build();

SunraClient client = SunraClient.withConfig(config);
Map<String, Object> input = Map.of(
    "prompt", "ein Hund, der im Park rennt");

Consumer<QueueStatus.StatusUpdate> statusUpdateHandler = update -> {
    String status = update.getStatus().toString();
    String message = String.format("\nStatus-Update: %s, Anfrage-ID: %s",
        status, update.getRequestId());
    System.out.println(message);
};

SubscribeOptions<JsonObject> options = SubscribeOptions.<JsonObject>builder()
    .input(input)
    .resultType(JsonObject.class)
    .onQueueUpdate(statusUpdateHandler)
    .logs(true)
    .build();

// die subscribe-Anfrage in einer Variablen speichern und ausgeben
var request = client.queue().submit("black-forest-labs/flux-kontext-pro/text-to-image", options);
```

##### Anfragestatus überprüfen

Rufen Sie den Status einer Anfrage ab.

**Beispiel:**

```java theme={null}
import ai.sunra.client.*;
import ai.sunra.client.queue.*;

ClientConfig config = ClientConfig.builder()
    .withCredentials(CredentialsResolver.fromEnv())
    .build();

SunraClient client = SunraClient.withConfig(config);
var job = client.queue().status(QueueStatusOptions.withRequestId("pd_eTYYuw4EqYLzRBHgnAMHA8zH"));
```

##### Anforderungsergebnisse abrufen

Rufen Sie das Ergebnis einer abgeschlossenen Anfrage ab.

**Beispiel:**

```java theme={null}
import ai.sunra.client.*;
import ai.sunra.client.queue.*;

ClientConfig config = ClientConfig.builder()
    .withCredentials(CredentialsResolver.fromEnv())
    .build();

SunraClient client = SunraClient.withConfig(config);
var result = client.queue().result(QueueStatusOptions.withRequestId("pd_eTYYuw4EqYLzRBHgnAMHA8zH"));
```

#### Datei-Uploads

<Note>Noch nicht implementiert.</Note>

<Note>Maximale Dateigröße: 100MB</Note>

### Unterstützung

Treten Sie unserer Community für Hilfe oder Diskussionen bei:

* **Discord-Community**: [Treten Sie uns bei](https://discord.gg/897qCzvCcU)
* **GitHub-Repository**: [Besuchen Sie hier](https://github.com/sunra-ai/sunra-clients)

Wir sind hier, um Ihnen zu helfen!