GetRouterДокументация
  • Русский

    • Claude Messages

    Используйте совместимый с Claude эндпоинт Messages для клиентов, отправляющих сообщения в формате Anthropic.

    POST https://getrouter.ai/v1/messages

    Базовый запрос

    curl https://getrouter.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "max_tokens": 512,
    "system": "Отвечай ясно и кратко.",
    "messages": [
      {"role": "user", "content": "Объясни назначение Base URL."}
    ]
  }'

    Ответ имеет совместимую с Claude структуру сообщения с блоками содержимого и, если доступно, сведениями об использовании.

    Обязательные поля

    ПолеОписание
    modelИдентификатор модели, совместимой с Claude
    messagesСообщения диалога
    max_tokensМаксимальное количество выходных токенов

    Необязательные поля

    Схема API включает такие поля, как:

    • system
    • temperature, top_p и top_k
    • stream
    • stop_sequences
    • tools и tool_choice
    • thinking
    • context_management
    • output_config и output_format
    • metadata
    • speed и service_tier

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

    Потоковые ответы

    Задайте для stream значение true, чтобы включить совместимую с Claude потоковую передачу, если она поддерживается:

    {
  "model": "MODEL_ID",
  "max_tokens": 512,
  "stream": true,
  "messages": [
    {"role": "user", "content": "Напиши короткую заметку о выпуске."}
  ]
}

    Используйте парсер событий Claude, а не парсер Chat Completions или Responses.

    Поддержка инструментов и рассуждений

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

    Warning

    Для одной и той же модели Claude при работе через OpenAI-совместимый эндпоинт и через /v1/messages могут требоваться разные способы обработки запросов и ответов. Настройте протокол, который ожидает ваш клиент.

    Интеграция с инструментами

    Инструментам, например клиентам для разработки, совместимым с Claude, могут требоваться дополнительные переменные окружения или настройки провайдера. Следуйте отдельному руководству в разделе Интеграции, а не ограничивайтесь заменой имени хоста.

    Что дальше