Текстовая серия
Claude Messages API
- Полная совместимость с форматом Claude Messages API
- Поддержка многошаговых диалогов и одиночных запросов
- Поддержка мультимодального контента, включая текст и изображения
POST
Documentation Index
Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
Use this file to discover all available pages before exploring further.
Авторизация
API-ключ для аутентификацииОткройте страницу управления API-ключами, чтобы получить ваш API-ключДобавьте в заголовок запроса:
Версия APIУказывает версию Claude API, которую нужно использоватьПример:
2025-10-01Body
Название модели
claude-haiku-4-5-20251001— Claude 4.5, версия с быстрым откликомclaude-sonnet-4-5-20250929— Claude 4.5, сбалансированная версияclaude-opus-4-1-20250805— самая мощная флагманская модель Claude 4.1claude-opus-4-1-20250805-thinking— Claude 4.1 Opus, версия с глубоким мышлениемclaude-sonnet-4-5-20250929-thinking— Claude 4.5 Sonnet, версия с глубоким мышлением
Список сообщенийМассив сообщений, на основе которых модель сгенерирует следующий ответ. Каждое сообщение содержит поля Многошаговый диалог:Предзаполненный ответ assistant:
role и content.💡 Быстрое заполнение (область «Try it»):- Нажмите «+ Add an item», чтобы добавить сообщение
- В поле
roleвведите:user(сообщение пользователя) илиassistant(ответ AI, для многошагового диалога) - В поле
contentвведите текст вашего сообщения
Максимальное количество генерируемых токеновМаксимальное количество токенов до остановки. Модель может остановиться до достижения этого лимита.У разных моделей разные максимальные значения. Минимум: 1
Системная подсказкаСистемные подсказки задают роль Claude, его характер, цели и инструкции.Строковый формат:Структурированный формат:
Параметр температуры, диапазон 0–1Управляет случайностью вывода:
- Низкие значения (например, 0.2): более детерминированный, консервативный
- Высокие значения (например, 0.8): более случайный, креативный
Параметр ядровой выборки (nucleus sampling), диапазон 0–1Использует ядровую выборку. Рекомендуется использовать либо
temperature, либо top_p, но не оба сразу.По умолчанию: 1.0Выборка Top-KВыборка только из верхних K вариантов, отсекает «длинный хвост» маловероятных ответов.Рекомендуется только для продвинутых сценариев.
Включение стримингаПри значении
true использует Server-Sent Events (SSE) для потоковой передачи ответов.По умолчанию: falseСтоп-последовательностиПользовательские текстовые последовательности, при которых модель прекращает генерацию.Максимум 4 последовательности.Пример:
["\n\nHuman:", "\n\nAssistant:"]МетаданныеОбъект метаданных для запроса.Включает:
user_id: идентификатор пользователя
Определения инструментовСписок инструментов, которые модель может использовать для выполнения задач.Пример функционального инструмента:Поддерживаемые типы инструментов:
- Пользовательские функциональные инструменты
- Инструмент работы с компьютером (computer_20241022)
- Инструмент текстового редактора (text_editor_20241022)
- Инструмент Bash (bash_20241022)
Стратегия выбора инструментаУправляет тем, как модель использует инструменты:
{"type": "auto"}: автоматическое решение (по умолчанию){"type": "any"}: обязательно использовать какой-либо инструмент{"type": "tool", "name": "tool_name"}: использовать конкретный инструмент
Response
Уникальный идентификатор сообщенияПример:
"msg_013Zva2CMHLNnXjNJJKqJ2EF"Тип объектаВсегда
"message"РольВсегда
"assistant"Массив блоков содержимогоКонтент, сгенерированный моделью, в виде массива блоков содержимого.Текстовый контент:Использование инструмента:Типы контента:
text: текстовый контентtool_use: вызов инструмента
Модель, обработавшая запросПример:
"claude-sonnet-4-5-20250929"Причина остановкиВозможные значения:
end_turn: естественное завершениеmax_tokens: достигнут лимит токеновstop_sequence: встретилась стоп-последовательностьtool_use: вызван инструмент
Сработавшая стоп-последовательностьСтоп-последовательность, которая была сгенерирована, если была; иначе
nullСтатистика использования токенов
Примеры использования
Базовый диалог
Многошаговый диалог
Использование системных подсказок
Потоковый ответ
Использование инструментов
Понимание изображений
Изображение в формате Base64
Лучшие практики
1. Промпт-инжиниринг
Чёткое определение роли:2. Обработка ошибок
3. Оптимизация токенов
4. Предзаполнение ответов
Обработка потоковых ответов
Стриминг в Python
Стриминг в JavaScript
Важные замечания
-
Безопасность API-ключей:
- Храните API-ключи в переменных окружения
- Никогда не зашивайте ключи в исходный код
- Регулярно ротируйте ключи
-
Ограничение частоты запросов:
- Учитывайте лимиты API
- Реализуйте механизмы повтора
- Используйте экспоненциальную задержку (exponential backoff)
-
Управление токенами:
- Отслеживайте расход токенов
- Оптимизируйте длину промптов
- Используйте подходящие значения max_tokens
-
Выбор модели:
- Opus: сложные задачи, требующие глубокого мышления
- Sonnet: сбалансированная производительность и стоимость
- Haiku: быстрый отклик, простые задачи
-
Фильтрация контента:
- Валидируйте пользовательский ввод
- Фильтруйте конфиденциальную информацию
- Реализуйте модерацию контента