Техническая документация: Grok API

Обзор Grok от xAI

Grok — это продвинутая нейросеть, разработанная компанией xAI (основана Илоном Маском). Модель отличается уникальным подходом к обработке информации, прямотой в ответах и способностью работать с большими объемами данных в реальном времени.

Ключевые особенности

Уникальные возможности Grok

• Многомодальность — обработка текста, изображений, аудио и видео
• Интеграция с X — доступ к данным платформы в реальном времени
• Режим "Развлечения" — специальный режим с более провокационными ответами
• Контекст 128K токенов — поддержка длинных диалогов и документов
• Поиск в интернете — возможность искать актуальную информацию
• Кастомизация ответов — настройка тона и стиля ответов

Технические преимущества

Быстрый старт

pip install xai-grok-sdk

npm install @xai/grok-sdk

import os
from grok_sdk import Grok

# Инициализация клиента
grok = Grok(api_key=os.getenv("GROK_API_KEY"))

# Простой запрос
response = grok.chat.completions.create(
    model="grok-beta",
    messages=[{"role": "user", "content": "Привет! Расскажи о себе"}],
    temperature=0.8
)

print(response.choices[0].message.content)

const { Grok } = require('@xai/grok-sdk');

// Инициализация клиента
const grok = new Grok({
    apiKey: process.env.GROK_API_KEY
});

// Простой запрос
async function askGrok() {
    const response = await grok.chat.completions.create({
        model: "grok-beta",
        messages: [{ role: "user", content: "Привет! Расскажи о себе" }],
        temperature: 0.8
    });
    
    console.log(response.choices[0].message.content);
}

askGrok();

Доступные модели

Grok предоставляет несколько специализированных моделей для различных задач:

Справочник API

Основные методы

Создание чат-завершения

response = grok.chat.completions.create(
    model="grok-beta",
    messages=[
        {"role": "system", "content": "Ты полезный ассистент Grok."},
        {"role": "user", "content": "Что такое искусственный интеллект?"}
    ],
    temperature=0.8,
    max_tokens=1000,
    top_p=0.9,
    frequency_penalty=0.5,
    presence_penalty=0.3,
    stream=False
)

Параметры запроса

Примеры кода

Пример 1: Чат с контекстом

from grok_sdk import Grok

grok = Grok(api_key="your-api-key")

# Начинаем диалог с Grok
messages = [
    {"role": "system", "content": "Ты - Грок, ассистент с чувством юмора."},
    {"role": "user", "content": "Какой самый странный факт о космосе ты знаешь?"}
]

response = grok.chat.completions.create(
    model="grok-beta",
    messages=messages,
    temperature=1.0,
    fun_mode=True
)

print(f"Grok: {response.choices[0].message.content}")

# Продолжаем диалог
messages.append({"role": "assistant", "content": response.choices[0].message.content})
messages.append({"role": "user", "content": "Расскажи еще что-нибудь интересное!"})

response2 = grok.chat.completions.create(
    model="grok-beta",
    messages=messages,
    temperature=1.2,
    fun_mode=True
)

print(f"Grok: {response2.choices[0].message.content}")

Пример 2: Анализ изображения

import base64
from grok_sdk import Grok

def encode_image(image_path):
    with open(image_path, "rb") as image_file:
        return base64.b64encode(image_file.read()).decode('utf-8')

grok = Grok(api_key="your-api-key")

# Кодируем изображение в base64
base64_image = encode_image("photo.jpg")

response = grok.chat.completions.create(
    model="grok-vision",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Что изображено на этой фотографии?"},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": f"data:image/jpeg;base64,{base64_image}"
                    }
                }
            ]
        }
    ],
    max_tokens=500
)

print(response.choices[0].message.content)

Пример 3: Анализ трендов в реальном времени

from grok_sdk import Grok

grok = Grok(api_key="your-api-key")

response = grok.chat.completions.create(
    model="grok-realtime",
    messages=[
        {
            "role": "user", 
            "content": "Какие основные тренды обсуждаются сейчас в технологической сфере?"
        }
    ],
    realtime_data=True,
    search_web=True,
    max_tokens=1000
)

print("Актуальные технологические тренды:")
print(response.choices[0].message.content)

# Анализ конкретной темы
response2 = grok.chat.completions.create(
    model="grok-realtime",
    messages=[
        {
            "role": "user", 
            "content": "Что говорят сегодня об искусственном интеллекте в образовании?"
        }
    ],
    realtime_data=True,
    search_web=True
)

print("\nОбсуждение ИИ в образовании:")
print(response2.choices[0].message.content)

Лучшие практики

Оптимизация запросов

• Используйте кэширование — Grok API поддерживает заголовки кэширования для идентичных запросов
• Пакетные запросы — объединяйте несколько запросов при работе с большими объемами данных
• Настройте температуру — для творческих задач используйте 1.0-1.5, для точных ответов — 0.2-0.5
• Лимитируйте токены — устанавливайте max_tokens в соответствии с потребностями

Обработка ошибок

from grok_sdk import Grok, GrokError
import time

grok = Grok(api_key="your-api-key")

def safe_grok_request(prompt, max_retries=3):
    for attempt in range(max_retries):
        try:
            response = grok.chat.completions.create(
                model="grok-beta",
                messages=[{"role": "user", "content": prompt}],
                temperature=0.8
            )
            return response.choices[0].message.content
            
        except GrokError as e:
            if e.status_code == 429:  # Rate limit
                wait_time = 2 ** attempt  # Exponential backoff
                print(f"Rate limit exceeded. Waiting {wait_time} seconds...")
                time.sleep(wait_time)
            elif e.status_code == 500:  # Server error
                print(f"Server error: {e.message}")
                if attempt == max_retries - 1:
                    raise
            else:
                raise

# Использование
try:
    answer = safe_grok_request("Что такое машинное обучение?")
    print(answer)
except Exception as e:
    print(f"Failed to get response: {e}")

Частые вопросы (FAQ)

Вопрос: Чем Grok отличается от других языковых моделей?

Ответ: Grok отличается прямотой ответов, интеграцией с платформой X для получения данных в реальном времени, специальным "развлекательным" режимом и уникальным подходом к обработке контекста.

Вопрос: Как получить доступ к Grok API?

Ответ: Доступ к API предоставляется через платформу X для разработчиков. Необходимо иметь аккаунт X Premium+ и зарегистрироваться в Developer Portal xAI.

Вопрос: Есть ли ограничения на использование API?

Ответ: Да, существуют ограничения на количество запросов в минуту (RPM) и токенов в месяц, которые зависят от вашего тарифного плана. Бесплатный тестовый план включает 1000 запросов в месяц.

Вопрос: Поддерживает ли Grok русский язык?

Ответ: Да, Grok отлично работает с русским языком и поддерживает более 50 языков мира с высокой точностью.

Вопрос: Как включить поиск в интернете?

Ответ: Используйте параметр search_web=True в запросе к API. Учтите, что это может увеличить время ответа и стоимость запроса.