Документация Grok ai api

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

Начните с генерации вашего API-ключа через панель управления или с помощью Google.

Направьте клиент на https://api.grokaiapi.com/v1 и передайте ключ в Authorization header. Этот базовый URL работает с любым OpenAI-совместимым SDK, позволяя вам подставить нашу модель без цензуры без переписывания логики интеграции.

Эндпоинт /v1/chat/completions

Отправляйте запросы POST на /v1/chat/completions для получения мгновенных текстовых ответов.

Наш API соответствует стандартным спецификациям OpenAI, что позволяет быстро интегрировать его в ваш существующий стек. Идентификатор модели — просто uncensored, обеспечивая прямой доступ к нашей неограниченной модели без прокси-маршрутизаторов.

Copycurl https://api.grokaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current version of the model?"}]
  }'

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

Используйте официальный Python SDK для обработки запросов с минимальным количеством кода.

Настройте базовый URL и API-ключ, затем вызовите конечный пункт chat completions. Этот подход сохраняет ваш код чистым и позволяет вам сосредоточиться на разработке функций вашего приложения, а не на ручном управлении HTTP-соединениями.

Copyfrom openai import OpenAI

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

Реализуйте интеграцию в Node.js, правильно установив переменные окружения.

SDK автоматически управляет жизненным циклом запроса, что упрощает добавление нашей uncensored LLM в ваши сервисы бэкенда. Вы можете управлять историей разговора и контекстным окном напрямую через стандартные структуры массивов.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.grokaiapi.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 в тело запроса.

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

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)

Лимиты, Ошибки и Контекст

Наш API поддерживает контекстное окно на 100,000 токенов для длительных разговоров.

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