API Gemma: первый запрос за пять минут

Базовый URL и аутентификация

Начните с создания аккаунта на странице Получить API-ключ. Вам нужен только адрес электронной почты и пароль; для активации бесплатного пробного баланса не требуется номер телефона или кредитная карта. После регистрации ваш API-ключ отображается сразу. Скопируйте этот ключ и сохраните его в безопасном месте. Используйте его в заголовке Authorization в виде токена Bearer для всех запросов. Базовый URL для всех эндпоинтов — https://api.gemma4api.com/v1. Этот URL работает с любым стандартным клиентом, совместимым с OpenAI, позволяя вам сменить провайдера, просто изменив базовый URL и API-ключ в конфигурации.

Первый запрос

Отправьте свой первый промпт с помощью curl, чтобы проверить подключение. Замените YOUR_API_KEY на ваш реальный ключ. Идентификатор модели — uncensored. Этот простой запрос «текст на вход, текст на выход» подтверждает, что аутентификация выполнена верно и модель отвечает. Если вы получили ответ JSON с массивом choices, ваша настройка завершена. Теперь вы можете приступить к интеграции SDK для более сложных рабочих процессов.

Copycurl https://api.gemma4api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Интеграция Python SDK

Установите официальный пакет OpenAI для Python. Установите базовый URL и API-ключ в переменные окружения или передайте их конструктору клиента. Используйте идентификатор модели uncensored, чтобы вызывать именно наш экземпляр. Этот подход сохраняет совместимость кода со стандартными шаблонами OpenAI, используя нашу модель без цензуры для генерации контента. SDK автоматически обрабатывает повторные попытки и парсинг JSON.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.gemma4api.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Интеграция Node.js SDK

Для сред JavaScript установите пакет OpenAI Node.js. Настройте клиент, указав базовый URL https://api.gemma4api.com/v1 и ваш API-ключ. Используйте идентификатор модели uncensored в ваших вызовах completion. Эта настройка позволяет сохранять стандартные структуры кода, совместимые с OpenAI, одновременно получая преимущества от специфического поведения модели, размещённой на наших серверах. Убедитесь, что вы правильно обрабатываете асинхронные ответы в цикле событий Node.js.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.gemma4api.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Потоковая передача ответов

Включите потоковую передачу, установив параметр stream в значение true в вашем API-запросе. Это возвращает поток Server-Sent Events (SSE), позволяя отображать токены по мере их генерации. Это идеально подходит для интерфейсов чата, где важна задержка. Каждый чанк содержит частичный дельта-ответ. Обработайте событие окончания потока, чтобы знать, когда генерация завершена. Этот метод значительно снижает воспринимаемую задержку по сравнению с ожиданием полного ответа.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Лимиты, ошибки и контекстное окно

Ваши запросы поддерживают контекстное окно объёмом 100 000 токенов для промпта и completion в сумме. Лимит запросов составляет 300 запросов в минуту на ключ, при этом максимальный размер тела запроса — 8 МБ. Распространённые ошибки: 401 для недействительных ключей, 402, если исчерпан предоплаченный баланс, и 429 при превышении лимита в минуту. Пересоздание API-ключа аннулирует старый, но не сбрасывает счётчик лимитов. Убедитесь, что ваш клиент appropriately обрабатывает эти коды состояния HTTP для обеспечения бесперебойной работы.