Java SDK

Отправьте один chat.completions запрос из Java через openai-java, а затем используйте ту же форму клиента в коде приложения.

Минимальный рабочий пример

Добавьте SDK:

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

Затем выполните один запрос chat.completions:

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

public class BasicUsage {
    public static void main(String[] args) {
        String apiKey = System.getenv("GONKAGATE_API_KEY");
        if (apiKey == null || apiKey.isBlank()) {
            throw new IllegalStateException("missing GONKAGATE_API_KEY");
        }

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

        ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
            .addUserMessage("Say hello from GonkaGate in one sentence.")
            .model("qwen/qwen3-235b-a22b-instruct-2507-fp8")
            .build();

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

        completion.choices().forEach(choice ->
            choice.message().content().ifPresent(System.out::println)
        );
    }
}

Ожидаемый результат: если программа выводит текст, значит Java-клиент подключён правильно.

Используйте актуальный model ID из GET /v1/models. Значение в примере выше приведено только для ориентира.

Что нужно заранее

• Java 8+, потому что это минимальная версия для openai-java
• API-ключ формата gp-..., сохранённый в GONKAGATE_API_KEY
• Достаточный доступный баланс для запроса
• Актуальный ID модели GonkaGate
• Если вы используете Maven вместо Gradle, возьмите те же координаты: com.openai:openai-java:4.29.0

Замечания для Java

• Задайте .baseUrl("https://api.gonkagate.com/v1") до создания клиента.
• По возможности переиспользуйте один клиент на всё приложение. SDK держит внутри пулы соединений и пулы потоков.
• Клиент по умолчанию синхронный. Если нужны вызовы на CompletableFuture, переключайтесь на client.async() или создавайте OpenAIOkHttpClientAsync.
• Если копируете старые примеры, обновляйте версию зависимости вместе с остальным кодом.

Частые ошибки и ограничения

• Если забыть .baseUrl("https://api.gonkagate.com/v1"), клиент уйдёт на стандартный эндпоинт OpenAI.
• 401 invalid_api_key обычно означает, что ключ отсутствует, передан в неверном формате, отозван или связан с недоступным состоянием аккаунта.
• 404 model_not_found означает, что указанный ID модели больше не доступен. Обновите его через GET /v1/models.
• 429 insufficient_quota означает, что доступного предоплаченного USD-баланса недостаточно для запроса.

См. также

• Совместимость OpenAI SDK для общих правил по base URL, формату ключей, выбору моделей и дополнительным полям usage во всех рантаймах.
• Аутентификация и API-ключи для создания, безопасного хранения и ротации ключей.
• Обзор справочника API GonkaGate, когда первый Java-запрос уже работает и вам нужны точные поля запроса, поведение стриминга и правила обработки сбоев.
• GET /v1/models для актуальных машинно-читаемых ID моделей.
• Гайд по миграции с OpenAI на GonkaGate, если вы переносите уже рабочий OpenAI-код, а не начинаете с нуля.