Дополнительные токены от использования инструментов поступают из:

  • Параметр tools в запросах API (названия инструментов, описания и схемы)
  • Блоки содержимого tool_use в запросах и ответах API
  • Блоки содержимого tool_result в запросах API

Когда вы используете tools, мы также автоматически включаем специальную системную подсказку для модели, которая включает использование инструментов. Количество токенов использования инструментов, необходимых для каждой модели, указано ниже (исключая дополнительные токены, перечисленные выше):

МодельКоличество токенов системной подсказки использования инструментов
Claude 3 Opus395 токенов
Claude 3 Sonnet159 токенов
Claude 3 Haiku264 токена

Эти количества токенов добавляются к вашим обычным входным и выходным токенам для расчета общей стоимости запроса. Обратитесь к нашей таблице обзора моделей для получения информации о текущих ценах для каждой модели.

Когда вы отправляете запрос с использованием инструментов, как и любой другой запрос API, ответ будет выводить количество как входных, так и выходных токенов в рамках отчетных метрик usage.

Имейте в виду, что использование инструментов часто требует нескольких обменов данными между вашим кодом и Claude (для выполнения инструментов и возврата результатов), поэтому один запрос конечного пользователя может привести к нескольким запросам API и связанным с ними затратам на токены. Разрабатывайте свои инструменты и подсказки так, чтобы они были максимально краткими, но при этом предоставляли достаточно информации для эффективного использования инструментов Claude.