POST messages — xAI
POST /xai/api/v1/messages создает сообщение в формате Anthropic Messages для текстовых моделей хаба; для Grok используется конвертация. Поля протокола описаны в документации Anthropic Messages; общий справочник — в документации xAI.
curl https://hub.coreinfra.ai/xai/api/v1/messages \
-H "x-api-key: $COREINFRA_API_KEY" \
-H 'anthropic-version: 2023-06-01' \
-H 'Content-Type: application/json' \
-d '{"model":"claude-haiku-4-5-20251001","max_tokens":64,"messages":[{"role":"user","content":"2 + 2"}]}'
Ожидаемый текст — 4. Фрагмент ответа:
{"content":[{"type":"text","text":"4"}]}
Отличия от API xAI
Для /xai/api/v1/messages действуют те же правила и ограничения Anthropic Messages, что и на адресе /anthropic/api/v1/messages:
- Поля
metadata.user_id,speed,inference_geo, бета-флагfast-mode-2026-02-01вanthropic-betaи заголовокx-grok-model-overrideигнорируются. - Поле
container, встроенные инструментыcode_execution*, ссылки на внешние ресурсы для изображений и документов иfile_idотклоняются со статус-кодом400. - Для моделей Grok (и других моделей без нативного протокола Messages) запрос конвертируется на стороне хаба, а ответ возвращается в формате Anthropic Messages.
Оплата
До отправки хаб резервирует средства по оценке запроса, затем рассчитывает стоимость по usage модели, включая кэш и рассуждения. Веб-поиск оплачивается отдельно. Конвертация учитывается в протоколе, в котором модель выполнила запрос. Правила резерва и расчета — на странице «Стоимость генеративных моделей», цены — на «Тарифах».
Ошибки
400— запрещенная возможность, неподходящий формат вложения или структурно некорректный запрос при конвертации.502— ошибка на стороне провайдера модели при выполнении запроса. Если ошибка возникла уже внутри SSE, поток завершается событием ошибки.
Формат ошибок приведен в разделе xAI API; общие ошибки ключа, выбора модели и баланса описаны в общем справочнике, ограничения — в разделе «Лимиты и ограничения».
