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

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

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

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

Отправьте стандартный запрос на завершение чата, чтобы проверить подключение. Идентификатор модели — uncensored, который обрабатывает отказ от контента иначе, чем стандартные модели. Ниже приведен базовый пример с использованием инструмента командной строки curl для проверки правильности вашего ключа и базового URL.

Copycurl https://api.groknsfw.top/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."}]
  }'

Если вы получили ответ в формате JSON с полями choices и usage, ваша интеграция активна. Проверьте объект usage, чтобы увидеть потребление токенов для точного отслеживания биллинга.

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

Используйте официальный пакет Python openai для взаимодействия с нашим эндпоинтом. Установите атрибуты base_url и api_key перед выполнением вызовов. Этот подход работает с любой библиотекой, поддерживающей схему OpenAI, что делает миграцию от других поставщиков простой.

Copyfrom openai import OpenAI

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

Этот фрагмент кода демонстрирует синхронный запрос. Для генерации NSFW-контента с высокой пропускной способностью рассмотрите возможность использования асинхронных клиентов для одновременной обработки нескольких запросов без блокировки основного потока.

Настройка Node.js SDK

Для приложений на JavaScript или TypeScript настройте SDK OpenAI на указание нашего базового URL. Это гарантирует, что ваш существующий клиентский код будет работать без изменений. Экосистема Node.js выигрывает от этой совместимости, позволяя быстро прототипировать NSFW-интерфейсы чатов.

Copyimport OpenAI from "openai";

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

Убедитесь, что вы используете последнюю версию SDK, поддерживающую пользовательские базовые URL. Объект конфигурации должен строго включать свойства apiKey и baseURL, чтобы избежать несоответствия эндпоинтов.

Потоковые ответы (SSE)

Включите генерацию токенов в реальном времени, установив 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)

Разбирайте события SSE, чтобы извлечь содержимое delta. Последний фрагмент потока содержит общую статистику usage, которую следует использовать для точного согласования биллинга. Потоковая передача не влияет на подсчет токенов или ценообразование.

Ограничения, ошибки и контекст

К вашим запросам применяются лимиты: 300 в минуту и 8 параллельных запросов на ключ. Максимальный размер тела запроса составляет 8 МБ, а контекстное окно поддерживает до 100 000 токенов. Ошибки возвращаются в стандартных форматах HTTP: 401 — недействительный ключ, 402 — недостаточно средств, 429 — превышен лимит запросов. Ошибки, связанные с кредитом, не влекут штрафов, но при достижении лимитов запросов необходимо снизить частоту запросов. Максимальный объём вывода на запрос — 32 000 токенов; если не указать max_tokens, по умолчанию используется 2 048 токенов.