Документація ключа Gemma api

Аутентифікація та базовий 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 повертає фрагменти подій, надсиланих сервером (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 означає, що ви вичерпали ліміт швидкості. Зачекайте кілька секунд і спробуйте знову.

Помилки не списуються з вашого кредиту. Якщо сталася подвійна списання, використайте сторінку Підтримки для її виправлення. Кредит ніколи не закінчується, тому ви можете поповнити його пізніше.

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"}]
  }'