Быстрый старт для пользователей Unhinged Grok

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

Наш API совместим с OpenAI, поэтому вам не нужна новая библиотека. Вам нужно обновить только два значения в существующей конфигурации: base_url и api_key. Ваш API-ключ генерируется сразу после регистрации через Google или email. Храните этот ключ в безопасности; это единственное удостоверение, необходимое для аутентификации.

Замените стандартный базовый URL OpenAI на наш эндпоинт. Это изменение направит все последующие запросы на серверы нашей модели без цензуры. Для базовой генерации текста не требуется других изменений в коде.

Пример конфигурации

• Базовый URL: https://api.unhingedgrok.com/v1
• API-ключ: Ваш уникальный ключ из панели управления

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

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

Начните с отправки простого запроса на текстовое завершение. Этот пример использует curl для демонстрации структуры HTTP-запроса. Запрос направлен на эндпоинт /v1/chat/completions с идентификатором модели uncensored. Ответ возвращает сгенерированный текст в массиве choices.

Этот прямой подход работает для любого языка или инструмента, поддерживающего стандартные форматы HTTP OpenAI. Вы можете протестировать его сразу после генерации ключа.

Прямой HTTP-запрос

Копироватьcurl https://api.unhingedgrok.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 для интеграции с нашим API. Установите пакет через pip. Инициализируйте клиент, передав ключ и пользовательский базовый URL. Остальные методы SDK, такие как chat.completions.create, работают точно так же, как описано для OpenAI.

Этот метод идеален для бэкенд-сервисов, скриптов обработки данных или автоматизированных рабочих процессов. SDK автоматически выполняет сериализацию JSON и разбор ответов.

Пример кода на Python

Копироватьfrom openai import OpenAI

client = OpenAI(base_url="https://api.unhingedgrok.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 или TypeScript используйте официальный npm-пакет openai. Настройте клиент, указав тот же базовый URL и ключ. SDK Node.js поддерживает как колбэки, так и промисы.

Эта настройка позволяет встроить генерацию текста без цензуры непосредственно в веб-приложения, серверные функции или инструменты автоматизации на Node.js. Обработка ошибок остается согласованной со стандартным поведением SDK OpenAI.

Пример кода на Node.js

Копироватьimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.unhingedgrok.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). Каждый чанк содержит частичный ответ. Последний чанк включает статистику использования токенов.

Потоковая передача снижает воспринимаемую задержку для конечных пользователей. Она необходима для интерфейсов чатов и интерактивных приложений. Обрабатывайте каждый чанк инкрементально, чтобы немедленно обновлять пользовательский интерфейс.

Пример кода потоковой передачи

Копироватьstream = 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 токенов в сумме, и если max_tokens не задан, ответ может достигать конца окна.

Лимит запросов позволяет 300 запросов в минуту на ключ. Параллельные запросы ограничены значением 8. Тела запросов не должны превышать 8 МБ. Обрабатывайте стандартные коды ошибок HTTP: 401 указывает на недействительный ключ, 402 сигнализирует о недостатке средств, а 429 обозначает превышение лимита. Ошибки не расходуют баланс.