Messages API подходит для Anthropic SDK и приложений, которые работают с content blocks.
Минимальный запрос#
curl https://api.dslab.tech/v1/messages \
-H "Content-Type: application/json" \
-H "X-Api-Key: $DSLAB_API_KEY" \
-d '{
"model": "<model-id>",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Объясни градиентный спуск в трех пунктах."}
]
}'Что отличается от Chat Completions#
системная инструкция передаётся отдельно от
messages;max_tokensнужно передавать явно;ответ содержит массив блоков
content, а неchoices;tool use и tool result представлены отдельными типами блоков;
thinking, если он включён, тоже возвращается отдельным блоком;
streaming использует именованные события, а не OpenAI chunks.
Thinking#
У разных моделей Anthropic способ управления размышлением различается. Одни используют ручной бюджет, другие — адаптивное thinking и уровень effort.
Не копируйте thinking между моделями без проверки страницы модели. Если вы возвращаете thinking blocks в следующем ходе, сохраняйте их структуру и служебные подписи без изменений.
Переносимость#
Обычный текст и function tools могут быть преобразованы в другой API-диалект. Provider-specific thinking, встроенные инструменты и часть sampling-параметров могут не иметь точного эквивалента.