Документація API, сумісна з OpenAI

Базова URL-адреса та аутентифікація

Почніть кожен запит, встановивши base_url до https://api.nsfwgemma.com/v1 і передаючи свій API-ключ у Authorization header. Ви отримуєте ключ одразу після реєстрації через Google або електронну пошту, без необхідності вказувати номер телефону. Зберігайте цей ключ у безпеці, оскільки це єдиний обліковий запис, необхідний для доступу до сервісу.

POST /v1/chat/completions: Параметри та приклади

Надішліть своє перше повідомлення до ендпоінту, використовуючи стандартний формат chat completions. Ідентифікатор моделі завжди "uncensored", а стиль виводу можна контролювати через параметри temperature та top_p. Цей ендпоінт обробляє всю генерацію тексту без необхідності складних локальних налаштувань.

Copycurl https://api.nsfwgemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top ten system prompts for the model"}]
  }'

Переконайтеся, що ваш пейлоад містить model field встановлено на "uncensored" та messages масив, що містить ваш запит. Система повертає структуровану відповідь у форматі JSON із згенерованим текстом.

GET /v1/models: Перелік доступних моделей

Запитайте до кінцевої точки models, щоб перевірити доступність екземпляра та підтвердити підключення. Цей GET-запит повертає метадані про поточну конфігурацію моделі без споживання кредитів. Використовуйте це для налагодження проблем із підключенням перед відправкою дорогих запитів на генерацію.

Copyfrom openai import OpenAI

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

Відповідь підтверджує ідентифікатор моделі та обмеження токенів, гарантуючи, що ваш клієнт правильно налаштований для uncensored великої мовної моделі.

Потокові відповіді з SSE

Увімкніть потокову передачу, встановивши stream: true отримувати токени в реальному часі через Server-Sent Events. Це зменшує сприйняту затримку для довгих творчих текстів або сценаріїв рольових ігор. Статистика використання токенів включається у останній чанк потоку.

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)

Парсуйте кожен об'єкт дельти, щоб поступово відображати текст, забезпечуючи більш плавний користувацький досвід для інтерактивних додатків чат-ботів NSFW.

Обробка помилок та використання токенів

Гарно обробляйте поширені HTTP-помилки: 401 вказує на недійсний або прострочений ключ, 402 означає необхідність поповнити кредит, а 429 сигналізує про вичерпання ліміту швидкості. Помилки не споживають ваш попередньо оплачений кредит, тому ви можете повторити запит без штрафів. Завжди перевіряйте usage field у успішних відповідях для відстеження споживання.

Ліміти частоти та конкурентність

Кожний API-ключ підтримує 300 запитів на хвилину та до 8 паралельних активних запитів. Максимальний розмір тіла запиту становить 8 МБ, що підходить для більшості стандартних контекстних вікон. Перевищення цих лімітів викликає помилку 429 доки вікно не скинеться.

Вікно контексту дозволяє до 100 000 токенів загалом, включаючи як промпт, так і відповідь. Максимальний обсяг відповіді становить 16 000 токенів за запит, або 2 048, якщо ви не вказали значення max_tokens. Налаштуйте паралелізм залежно від шаблонів трафіку вашого додатка.

Підтримувані параметри: Temperature, Top P та інше

Керуйте випадковістю та детермінованістю за допомогою temperature, top_p, stop, seed, та параметри штрафів. Використовуйте response_format встановлено на {"type": "json_object"} для виводу структурованих даних. Виклик функцій підтримується через tools параметр для розширених інтеграцій.

Ці параметри дозволяють тонко налаштувати поведінку uncensored моделі, гарантуючи, що вона відповідає вашим конкретним вимогам до NSFW-контенту без несподіваних відмов.

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.nsfwgemma.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);