Grok API: ключ, Base URL и подключение (2026)

Grok — серия моделей xAI. API использует формат, совместимый с OpenAI, поэтому разработчики могут обращаться к нему через уже знакомый OpenAI SDK. При работе из Китая типичные вопросы — доступ к сервису, оплата и управление лимитами моделей.

В этой статье разобрано, как получить Grok API, как его вызывать и как подключиться через шлюз.

Примечание: Grok и xAI — товарные знаки соответствующих правообладателей. Примеры основаны на распространённых версиях октября 2026 года; интерфейсы и цены уточняйте в официальной документации и на странице цены на модели.

1. Что умеет Grok API

Общие вопросы и ответы, написание текстов, summarization.
Генерация и объяснение кода.
Вызов инструментов и сценарии Agent.
Анализ документов с длинным контекстом.
Сравнительное тестирование нескольких моделей.

Конкретные доступные названия моделей и длина контекста указаны на странице цены на модели. Перед проектированием нагрузки стоит сверить список моделей: у разных версий отличаются не только лимиты, но и поддержка параметров.

2. Два пути получения ключа

Официальный xAI

Создайте API Key в консоли xAI и привяжите способ оплаты. Этот вариант подходит командам, у которых есть стабильный доступ к сервису и зарубежное платёжное средство. Учитывайте, что аккаунт, регион и платёжный метод должны соответствовать условиям платформы.

Шлюз ZSQH AI Gateway

Откройте ZSQH AI Gateway и зарегистрируйтесь.
Создайте API Key и задайте лимит.
Пополните баланс.
Вызывайте модель через OpenAI SDK или curl.

Вариант подходит командам, которым нужен стабильный доступ из Китая, единый счёт и переключение между несколькими моделями. Один ключ шлюза может обслуживать несколько моделей, если они подключены в вашем тарифе.

3. Base URL

Официальный адрес xAI обычно выглядит так:

https://api.x.ai/v1

Совместимый с OpenAI вход ZSQH AI Gateway:

https://ai.zhongshangqihang.com/v1

Не смешивайте два адреса: ключ и Base URL должны быть из одного контура. Если использовать ключ шлюза с официальным адресом или наоборот, запрос вернёт ошибку авторизации.

4. Проверка через curl

export GROK_API_KEY="sk-ваш-ключ"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $GROK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4",
    "messages": [{"role": "user", "content": "Ответь только OK"}]
  }'

Название модели уточняйте на странице цены на модели. Если запрос завершился успешно, в ответе будет объект с полем choices; это базовая проверка ключа, адреса и доступности модели.

5. Вызов из Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-ваш-ключ",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="grok-4",
    messages=[{"role": "user", "content": "Объясни API-шлюз в трёх предложениях"}],
)
print(resp.choices[0].message.content)

Пример подходит для первичной проверки. В рабочем коде добавьте тайм-ауты, повторные попытки с задержкой и обработку ошибок — иначе единичный сбой сети может остановить весь сценарий.

6. Частые ошибки

Ошибка	Причина	Что делать
401	Ключ и адрес не совпадают	Проверить Key и Base URL
404	Неверный путь	Указывать путь только до `/v1`
model not found	Неверное название модели	Скопировать название со страницы цен
429	Ограничение частоты	Снизить параллелизм, повторить позже
insufficient quota	Недостаточно средств	Пополнить баланс

7. Затраты и выбор модели

На стоимость Grok влияют ставка модели, длина контекста и вызовы инструментов. Порядок оценки:

Посчитайте средний дневной объём входных и выходных токенов.
Сверьте текущую ставку выбранной модели.
Добавьте запас на повторы и длинный контекст.
Сравните с другими моделями и распределите задачи.

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

Частые вопросы

Совместим ли Grok API с OpenAI?

Обычно поддерживается формат Chat Completions, поэтому можно использовать OpenAI SDK. Конкретный набор параметров уточняйте в официальной документации или документации шлюза.

Как обеспечить стабильный доступ из Китая?

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

Можно ли одним ключом вызывать несколько моделей?

В шлюзе — да, модель указывается в параметрах запроса. Официальный ключ xAI даёт доступ только к моделям xAI.

Что дальше

Если нужен доступ из Китая или единая точка входа для нескольких моделей, начните с регистрации в ZSQH AI Gateway и небольшого тестового ключа. Модели и цены указаны на странице цены на модели.