Перейти к содержанию

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; общие ошибки ключа, выбора модели и баланса описаны в общем справочнике, ограничения — в разделе «Лимиты и ограничения».