Документація API

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

Почніть із генерації вашого ключа через панель керування. Використовуйте базову URL-адресу https://api.grokapipricing.com/v1 для всіх запитів. Встановіть Authorization header для Bearer YOUR_API_KEY. Цей єдиний ключ працює на всіх ендпоінтах. Вільно обмінюйте його за потреби.

POST /v1/chat/completions

Надішліть свої промпти до кінцевої точки chat. Ідентифікатор моделі завжди uncensored. Налаштуйте параметри, такі як temperature або top_p для контролю креативності. Відповіді повертають стандартні завершення чату з метаданими про використання токенів. Помилки, такі як 402 або 429, вказують на проблеми з оплатою або лімітами швидкості.

GET /v1/models

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

Потокова передача та використання SSE

Увімкніть потокову передачу, встановивши stream: true у тілі вашого запиту. API повертає події, надіслані сервером (SSE), для доставки токенів у реальному часі. Статистика використання токенів з’являється в останньому фрагменті потоку. Це зменшує сприйняту затримку для довгих відповідей.

Function Calling та режим JSON

Використовувати response_format з {"type": "json_object"} для суворого виводу JSON. Увімкніть виклик функцій, визначивши tools у вашому запиті. Модель підтримує tool_choice для примусового або автоматичного виконання. Це забезпечує надійну інтеграцію з логікою вашого бекенду.

Ліміти частоти та обмеження

Вам доступно не більше 300 запитів на хвилину на кожен ключ. Ліміт паралельних запитів становить 8 одночасних запитів. Максимальний розмір тіла запиту — 8 МБ. Контекстне вікно дозволяє 100 000 токенів загалом. Запити, що перевищують ці ліміти, одразу отримують помилки 429 або 400.

cURL

Copycurl https://api.grokapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run query and return rows"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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

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)