Документация ключа API Gemma

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

Используйте свой уникальный API-ключ для аутентификации каждого запроса. Базовый URL — HTTPS://api.gemmaapikey.com/v1, и вы отправляете ключ в заголовке Authorization. Это работает с любым совместимым с OpenAI клиентом путем изменения base_url и API-ключа. Если вы его потеряете, сгенерируйте новый на панели управления. Старый ключ немедленно перестанет работать. Ошибки и отказы не расходуют вашу предоплаченную кредитную сумму.

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

Отправьте POST-запрос на /v1/chat/completions с идентификатором модели "uncensored". Включите системную подсказку и сообщение пользователя в массив messages. Модель отвечает текстом, сгенерированным без отказов в контенте для законного использования взрослыми.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.gemmaapikey.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)

Установите temperature и top_p, чтобы контролировать случайность. Используйте последовательности stop, чтобы досрочно остановить генерацию. В ответе содержится информация об использовании токенов в последнем фрагменте, если включена потоковая передача.

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

Установите официальный SDK OpenAI для Node.js. Настройте его с вашим ключом API и базовым URL из этого руководства. Вызовите метод chat.completions.create с вашим промптом.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.gemmaapikey.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 токенов для промпта и завершения вместе.

Лимиты запросов и контекст

Лимит составляет 300 запросов в минуту на один ключ. Одновременно может выполняться только 8 запросов. Размер тела запроса не должен превышать 8 МБ. Эти ограничения обеспечивают стабильную работу для всех пользователей.

Модель поддерживает вызов функций, режим JSON и стандартные параметры, такие как seed и presence_penalty. Максимальный объем вывода — 16,000 токенов за запрос. Если не указать max_tokens, по умолчанию используется значение 2,048.

Ошибки и устранение неполадок

Ошибка 401 означает, что ваш API-ключ недействителен или истек. Проверьте панель управления на наличие активного ключа. Ошибка 402 указывает на недостаточный предоплаченный баланс. Пополните счет через криптовалюту, чтобы продолжить. Ошибка 429 означает превышение лимита скорости. Подождите несколько секунд и повторите попытку.

Ошибки не списывают средства с вашего кредита. Если произошло двойное списание, используйте страницу Support для исправления. Кредит не истекает, поэтому вы можете пополнить его позже.

cURL

Copycurl https://api.gemmaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the current system status"}]
  }'