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

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

Наш API полностью совместим с SDK OpenAI. Вам нужно лишь обновить значение base_url и передать ваш ключ в заголовке Authorization. Зарегистрируйтесь через Google или электронную почту, чтобы мгновенно получить ключ. Для начала не нужен номер телефона или кредитная карта. Используйте идентификатор модели uncensored во всех запросах.

Аутентификация осуществляется через Bearer-токены. Убедитесь, что ключ передается в заголовке каждого запроса. Ошибка 401 означает, что ключ недействителен или истек. Наш сервис независим и не перепродает модели других вендоров.

Базовое завершение чата

Отправьте стандартный запрос POST на /v1/chat/completions. API принимает текстовый ввод и возвращает текстовый вывод. Вы можете задать системные промпты для управления поведением модели. Модель отвечает без отказов на законный контент для взрослых, художественную литературу или спорные темы.

Укажите модель uncensored в полезной нагрузке. Контекстное окно поддерживает до 100 000 токенов суммарно. Максимальный вывод — 32 000 токенов на запрос. Ошибки и отказы не расходуют баланс.

Потоковые ответы

Включите потоковую передачу, установив stream: true. API возвращает Server-Sent Events (SSE). Каждый чанк содержит инкрементальные обновления текста. Последний чанк содержит статистику использования токенов для прозрачности биллинга.

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

Вызов функций

Определите инструменты в параметре tools. Модель может возвращать структурированные вызовы инструментов. Используйте tool_choice для принудительного поведения. Это позволяет интегрировать внешние системы и рабочие процессы.

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

JSON-режим

Установите response_format в {"type": "json_object"} для строгого вывода JSON. Модель отформатирует ответ как валидный JSON. Это полезно для разбора структурированных данных в приложениях.

JSON-режим обеспечивает согласованное форматирование. Используйте его, когда код ожидает определенные структуры схемы. Модель соблюдает запрошенный формат. Это снижает необходимость в дополнительной логике парсинга.

Параметры, лимиты и ошибки

Управляйте генерацией с помощью параметров temperature, top_p и последовательностей остановки stop. Лимит запросов составляет 300 запросов в минуту на ключ. Вы можете выполнять до 8 параллельных запросов. Тело запроса не должно превышать 8 Мб. Ошибка 402 означает недостаточный баланс. Ошибка 429 означает, что вы исчерпали лимит запросов. Предоплаченный баланс не сгорает. Ошибки бесплатны.

cURL

Copycurl https://api.grokuncensored.cc/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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Потоковая передача

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)