Java SDK

Используйте официальный OpenAI Java SDK с GonkaGate. Работает с Java 8+ и всеми популярными системами сборки.

Официальный SDK

Мы рекомендуем использовать официальный OpenAI Java SDK с полной совместимостью API.

github.com/openai/openai-java

Чтобы получить API-ключ, базовый URL и первый запрос, начните с руководства Quickstart .

Установка

Добавьте SDK в проект:

Gradle (Kotlin DSL)

build.gradle.kts

implementation("com.openai:openai-java:4.7.1")

Maven

pom.xml

<dependency>
    <groupId>com.openai</groupId>
    <artifactId>openai-java</artifactId>
    <version>4.7.1</version>
</dependency>

Настройка

Настройте клиент для использования API GonkaGate:

Config.java

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;

OpenAIClient client = OpenAIOkHttpClient.builder()
    .apiKey("gp-your-api-key")
    .baseUrl("https://api.gonkagate.com/v1")
    .build();

Базовое использование

Выполните первый запрос к чату:

BasicUsage.java

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.ChatModel;
import com.openai.models.chat.completions.ChatCompletion;
import com.openai.models.chat.completions.ChatCompletionCreateParams;

public class BasicUsage {
    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.builder()
            .apiKey("gp-your-api-key")
            .baseUrl("https://api.gonkagate.com/v1")
            .build();

        ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
            .addSystemMessage("You are a helpful assistant.")
            .addUserMessage("Hello, how are you?")
            .model("qwen/qwen3-235b-a22b-instruct-2507-fp8")
            .temperature(0.7)
            .maxTokens(1000)
            .build();

        ChatCompletion completion = client.chat().completions().create(params);

        System.out.println(completion.choices().get(0).message().content());
    }
}

CompletableFuture

Используйте CompletableFuture для неблокирующих запросов:

AsyncUsage.java

import com.openai.client.OpenAIClientAsync;
import com.openai.client.okhttp.OpenAIOkHttpClientAsync;
import com.openai.models.chat.completions.ChatCompletion;
import com.openai.models.chat.completions.ChatCompletionCreateParams;
import java.util.concurrent.CompletableFuture;

public class AsyncUsage {
    public static void main(String[] args) {
        OpenAIClientAsync client = OpenAIOkHttpClientAsync.builder()
            .apiKey("gp-your-api-key")
            .baseUrl("https://api.gonkagate.com/v1")
            .build();

        ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
            .addUserMessage("Hello!")
            .model("qwen/qwen3-235b-a22b-instruct-2507-fp8")
            .build();

        CompletableFuture<ChatCompletion> future =
            client.chat().completions().create(params);

        future.thenAccept(completion -> {
            System.out.println(completion.choices().get(0).message().content());
        }).exceptionally(e -> {
            System.err.println("Error: " + e.getMessage());
            return null;
        }).join();
    }
}

Заметки по языку

Несколько советов для Java:

Переиспользуйте экземпляры OkHttp.
Явно задайте таймауты connect и read.
Используйте streaming, если нужны частичные ответы.

Смотрите Streaming и обработку ошибок для стриминга и ретраев.