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

POST messages — Anthropic

POST /anthropic/api/v1/messages создает сообщение для текстовой генеративной модели: напрямую или с конвертацией в другой протокол. Поля запроса и ответа описаны в документации Anthropic Messages.

curl https://hub.coreinfra.ai/anthropic/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 Anthropic​

Поля и возможности​

Поля metadata.user_id, speed и inference_geo игнорируются; запросы к моделям Anthropic выполняются в стандартном режиме обслуживания (standard_only).

Бета-флаг fast-mode-2026-02-01 в заголовке anthropic-beta и заголовок x-grok-model-override игнорируются: модель выбирается полем model в теле запроса.

Поле container и встроенные инструменты с type, начинающимся на code_execution, отклоняются со статус-кодом 400. Изображения и документы передаются в кодировке base64 (или текстом в document). Ссылки на внешние ресурсы и file_id отклоняются со статус-кодом 400, в том числе внутри результатов инструментов.

При конвертации​

Когда выбранная модель не поддерживает Anthropic Messages напрямую, хаб конвертирует запрос и возвращает ответ в формате Anthropic Messages (включая SSE):

  • Не конвертируются top_k, context_management, safeguards, speed, inference_geo, cache_control верхнего уровня, container, thinking.budget_tokens, thinking.block_binding и messages[].output_config.
  • Текстовые блоки system объединяются в строку (без citations и cache_control). При конфликте output_config.effort имеет приоритет над thinking; если модель не поддерживает рассуждения, настройка рассуждений игнорируется.
  • Конвертируются только пользовательские инструменты без type или с type: "custom" (без cache_control, max_uses, eager_input_streaming, allowed_domains, blocked_domains и defer_loading).
  • В блоках содержимого не конвертируются citations, context у документов, caller у tool_use, а также блоки redacted_thinking, server_tool_use и web_search_tool_result.
  • При конвертации в OpenAI Responses значение max_tokens ниже 16 повышается до 16, а stop_sequences не конвертируется.

Оплата​

До отправки хаб резервирует средства по оценке запроса, затем рассчитывает стоимость по usage модели, включая кэш и рассуждения. Веб-поиск оплачивается отдельно. Конвертация учитывается в протоколе, в котором модель выполнила запрос. Правила резерва и расчета — на странице «Стоимость генеративных моделей», цены — на «Тарифах».

Ошибки​

  • 400 — запрещенная возможность, неподходящий формат вложения или структурно некорректный запрос при конвертации.
  • 502 — ошибка на стороне провайдера модели при выполнении запроса. Если ошибка возникла после начала потока SSE, поток завершается событием ошибки.

Формат ошибок приведен в разделе Anthropic API; общие ошибки ключа, выбора модели и баланса описаны в общем справочнике, ограничения — в разделе «Лимиты и ограничения».