xAI-совместимый API
xAI-совместимый API хаба позволяет вызывать модели Grok и другие генеративные модели через хаб без VPN из клиентов xAI и Grok Build по ключу хаба.
1. Настройте адрес и ключ
Укажите в клиенте базовый адрес https://hub.coreinfra.ai/xai/api/v1 и подставьте ключ хаба sk-ci2-... в заголовок Authorization: Bearer.
Проверьте OpenAI Responses через cURL:
export COREINFRA_API_KEY='sk-ci2-...'
curl https://hub.coreinfra.ai/xai/api/v1/responses \
-H "Authorization: Bearer $COREINFRA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"grok-4.7","input":"2 + 2"}'
Ожидаемый текст ответа — 4. Для клиента OpenAI Chat Completions базовый адрес тот же.
Отличия от API xAI
Полное описание параметров приведено в документации xAI. При работе через хаб действуют следующие отличия:
- Адрес API обслуживает только API методы из таблицы ниже. Изображения, видео, Files, Batches и голосовые API xAI через него не предоставляются. WebSocket для Responses у этого адреса API не поддерживается.
- Заголовок
x-grok-model-overrideи полеinference_geoигнорируются (модель выбирается полемmodelв теле запроса). Для моделей Grok в Responses и Chat Completions игнорируютсяuser,safety_identifierиservice_tier, а в Responses также отключено сохранение на стороне провайдера (store: false); правила для моделей других провайдеров приведены в справочниках Responses и Chat Completions. - В Responses отклоняются со статус-кодом
400параметрыbackground: true,prompt,conversation, MCP сtunnel_idи встроенные инструменты провайдера (code_interpreter,file_search,image_generation,x_search,code_execution,collections_search,attachment_searchи контейнерныйshell). - В Chat Completions отклоняются со статус-кодом
400параметрdeferred: trueи встроенные инструменты (code_interpreter,code_execution,file_search,collections_search,x_search,web_search,retrieval,builtin_function). Используйте пользовательские функции (type: "function"). - Для
/xai/api/v1/messagesдействуют отличия Anthropic-совместимого API. - Входные изображения и файлы передавайте в кодировке base64. Ссылки на внешние ресурсы и
file_idотклоняются со статус-кодом400. - Когда ответ модели Grok через Responses или Chat Completions (без конвертации) содержит данные о стоимости и сумма списания рассчитана, хаб возвращает стоимость запроса в рублях в поле
usage.cost_rub.
Конвертация
Когда выбранная модель не поддерживает вызванный протокол напрямую (например, вызов Grok через /xai/api/v1/messages или вызов моделей Anthropic и Google через /xai/api/v1/responses), хаб конвертирует запрос и ответ на своей стороне:
- В Responses при конвертации не поддерживаются
previous_response_id,conversationиitem_reference(возвращается ошибка со статус-кодом400— передавайте историю вinput). - В Chat Completions при конвертации формируется один вариант ответа (
n: 1) и не конвертируютсяlogprobs,top_logprobsиlogit_bias. Подробности приведены в справочнике xAI API.
Что доступно
Доступны следующие API методы относительно https://hub.coreinfra.ai/xai/api/v1:
| Метод | Путь | Назначение и справочник |
|---|---|---|
GET | /models | Каталог моделей клиента |
POST | /responses | OpenAI Responses |
POST | /chat/completions | OpenAI Chat Completions |
POST | /messages | Anthropic Messages |
GET | /api-key | Проверка запуска клиента |
Каталог GET /models подготовлен для клиента Grok Build и включает генеративные модели разных провайдеров с префиксом [CoreInfra] и полем api_backend. Возможности всех моделей смотрите в каталоге моделей, цены — на странице «Тарифы».
Ошибки
В Responses и Chat Completions ошибки проверки параметров возвращаются в формате ошибок OpenAI, а в /xai/api/v1/messages — в формате ошибок Anthropic Messages; примеры приведены в справочнике xAI API. Общие ошибки авторизации, баланса и лимитов расходов описаны в общем справочнике API и на странице «Лимиты и ограничения».
