Grok API: інтеграція Grok у власний код

Два способи підключити Grok у коді

Розробники можуть викликати моделі Grok двома основними шляхами. Перший — це xAI API напряму від компанії (яка тепер має бренд SpaceXSI), ключі до якого видаються на console.x.ai. Другий — маршрутизатор моделей, як-от OpenRouter, який об'єднує моделі багатьох постачальників під одним ключем та єдиним рахунком. Обидва варіанти приймають запити у форматі OpenAI Chat Completions, тож офіційні бібліотеки OpenAI SDK працюють відразу — достатньо змінити базову адресу та назву моделі.

Який варіант обрати

• xAI API, якщо ви хочете першими отримувати всі нові можливості Grok: повний список моделей, Responses API, серверний пошук в інтернеті та в X, генерацію зображень і відео через Grok Imagine, голос, пакетну обробку (batch) та знижки за кешування промптів. Базовий URL: https://api.x.ai/v1.
• OpenRouter, якщо ви хочете перемикатися між Grok та моделями інших розробників без нових контрактів, або якщо у вас уже є акаунт OpenRouter. Базовий URL: https://openrouter.ai/api/v1, а ідентифікатори моделей мають префікс x-ai/. Інструкція з налаштування є у посібнику OpenRouter.

У будь-якому разі зберігайте ключ на сервері або в змінних оточення. Ніколи не вшивайте його у код вебсторінки чи мобільного застосунку, де його може побачити будь-хто.

Ваш перший запит до xAI API

Створіть ключ у консолі, збережіть його як XAI_API_KEY і надішліть повідомлення моделі Grok 4.7:

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Give me three tips for a first marathon."}
    ]
  }'

Python з бібліотекою OpenAI

import os
from openai import OpenAI

grok = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "Is 391 a prime number? Show your check."}],
)
print(answer.choices[0].message.content)

Параметр reasoning_effort визначає, як довго модель роздумує перед відповіддю. Grok 4.3 підтримує none, low, medium, high та xhigh (типово: low); Grok 4.7 підтримує low, medium, high та xhigh (типово: high). Для Grok 4.20 компанія xAI використовує окремі ідентифікатори: grok-4.20-0309-reasoning та grok-4.20-0309-non-reasoning.

Те саме через OpenRouter

В OpenRouter збережіть ключ у OPENROUTER_API_KEY і використовуйте ідентифікатори з префіксом x-ai/. OpenRouter керує міркуваннями через окремий об'єкт reasoning. Цей код на JavaScript працює в Node.js 18 або новіших версіях:

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "Rewrite this headline in a calmer tone: PRICES EXPLODE AGAIN" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Щоб увімкнути режим міркувань, надішліть замість цього reasoning: { effort: "low" } (або medium, high). Додайте exclude: true, якщо хочете використати міркування, але не отримувати їх у відповіді. Встановіть stream: true, щоб отримувати відповідь у реальному часі під час її генерації — це значно покращує відгук інтерфейсу чату.

Надсилання зображень

Grok 4.20, 4.3 та 4.7 підтримують роботу із зображеннями. Використовуйте стандартний для OpenAI формат повідомлення зі списком частин контенту. Згідно з документацією xAI, підтримуються зображення у форматах JPEG та PNG розміром до 20 МіБ; підійде як публічний URL, так і рядок даних base64.

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "List the items and the total on this receipt."}
    ]
  }]
}

Ідентифікатори моделей Grok і ціни

Нижче наведено актуальні текстові моделі SpaceXAI, доступні на OpenRouter, із розміром контексту та цінами за мільйон токенів (прайс-лист OpenRouter, жовтень 2026 року). xAI API стягує таку саму базову плату за промпти розміром до 200 000 токенів.

Деякі важливі деталі зі сторінки моделей і тарифів xAI (офіційні ціни xAI, жовтень 2026 року):

• Довгі промпти коштують дорожче. Якщо обсяг промпту сягає 200 000 токенів, весь запит тарифікується за вищою ставкою: $4 / $12 для Grok 4.7 та $2.50 / $5 для Grok 4.3 і 4.20.
• Кешовані вхідні дані дешевші: $0.50 за мільйон токенів для Grok 4.7 та $0.20 для Grok 4.3 і 4.20 за повторювані префікси промптів.
• Пакетна обробка (Batch) без терміновості пропонується зі знижкою; OpenRouter також додає x-ai/grok-4.3:batch за тарифом $1 / $2.
• Різниця в обсязі контексту: OpenRouter вказує 2 000 000 токенів для Grok 4.20, тоді як на сторінці xAI зазначено 1 000 000.

Токени роздумів рахуються як вихідні (output), тому вартість однієї відповіді моделі з reasoning може виявитися вищою, ніж здається за базовим тарифом.

Практичні поради

• Почніть із Grok 4.20 без reasoning для чатів, переписування тексту та вилучення даних. Вона швидка й економна. Переходьте на Grok 4.3 або 4.7, коли якість виконання складних завдань важливіша за швидкість.
• Зважайте на актуальність бази знань. За даними xAI, модель Grok 4.7 володіє інформацією до травня 2026 року. Для свіжіших подій передавайте потрібні факти в промпті або використовуйте інструменти xAI для вебпошуку та пошуку в X, які оплачуються за кожен виклик.
• Задавайте системне повідомлення з описом ролі, тону та бажаного формату виводу, а для парсингу в коді вимагайте відповідь у JSON за схемою.
• Обробляйте ліміти запитів. Якщо ви отримали помилку 429, зачекайте невелику паузу та надішліть запит повторно.
• Дотримуйтеся правил. Використання API регулюється правилами прийнятного використання xAI, а поле safety_identifier дозволяє маркувати запити за окремими кінцевими користувачами.

Якщо щось пішло не так

• Помилка 401 або 403: ключ відсутній, відкликаний або завантажений не в те середовище. Виведіть кілька перших символів ключа на сервері, щоб перевірити його наявність.
• Model not found: перевірте префікс. OpenRouter очікує x-ai/grok-4.7, а xAI — просто grok-4.7.
• Порожні або дуже повільні відповіді від моделі з reasoning зазвичай означають, що вона витратила весь ліміт вихідних токенів на міркування. Зменште рівень effort або збільште max_tokens.
• Зображення відхилено: конвертуйте його в JPEG або PNG і переконайтеся, що файл не перевищує ліміт за розміром.

Часті запитання

Чи сумісний Grok API з бібліотекою OpenAI SDK?

Так. Достатньо вказати в SDK адресу https://api.x.ai/v1 із ключем xAI або адресу OpenRouter із відповідним ключем, а також задати ідентифікатор моделі Grok.

Чи є безкоштовний тариф для Grok API?

Постійного безкоштовного тарифу немає. Як xAI, так і OpenRouter стягують плату за токени, хоча короткі тестові запити коштують зовсім небагато.

Чи можна генерувати зображення через Grok API?

Так, за допомогою моделей Grok Imagine від xAI на окремому ендпоінті для зображень. Дивіться деталі на нашій сторінці Grok Imagine. У нашому чаті генерації зображень немає.

Яку модель Grok використовує Grok.Online?

У нашому чаті доступні моделі Grok 4.20 з вимкненим reasoning, Grok 4.3 з низьким рівнем міркувань (low) та Grok 4.7 з лімітом до 10 повідомлень на день — усі вони підключені через OpenRouter.