Новые функции Claude API: как начать — переключатель длинного вывода, оценка в Workbench и панель затрат

Если вы недавно используете Claude API для резюмирования, написания кода или генерации длинных текстов, самое заметное изменение — «можно выводить больше», а консоль разработчика стала удобнее. В этой статье по пунктам разбираются несколько новых функций Claude API: как включить длинный вывод, как использовать Workbench для оценки промптов и как разобраться с расходами на панели.

Длинный вывод Claude API: Sonnet 3.5 — с 4096 до 8192

Claude API повысил максимальный лимит выходных токенов для Claude Sonnet 3.5 до 8192, но это нужно явно включить. При вызове Claude API добавьте в заголовок запроса anthropic-beta — это активирует более длинное окно вывода и подходит для разовой генерации более полного отчёта, длинного файла с кодом или многочастного резюме.

Конкретная запись предельно ясна: добавьте заголовок anthropic-beta: max-tokens-3-5-sonnet-2024-07-15. Если в Claude API вы сталкиваетесь с тем, что «вывод обрезается», в первую очередь проверьте, не забыли ли вы этот переключатель, и достаточно ли велико значение max_tokens.

Workbench стал удобнее: генератор промптов и режим оценки

В Workbench в консоли Claude в отладочный опыт Claude API добавили два ключевых инструмента. Первый — «генератор промптов»: вам достаточно описать цель задачи (например, «классифицировать входящие запросы в службу поддержки»), и он выдаст структурированный черновик промпта, который можно сразу копировать в Claude API.

Второй — «режим оценки»: вы запускаете две или несколько версий промптов параллельно на одном и том же наборе входных данных; результаты выводятся рядом для сравнения, а качество можно оценивать по 5-балльной шкале. Для сценариев Claude API, где важна стабильность результатов (маршрутизация обращений в поддержку, извлечение информации, комплаенс-переписывание), этот шаг заметно снижает долю «подкруток на глаз».

Панель использования и расходов: посчитать стоимость Claude API

После появления в консоли разработчика вкладок «Использование» и «Расходы» по Claude API больше не нужно ориентироваться только на ощущения. Вы можете отслеживать потребление по сумме в долларах, числу токенов и по API Key, быстро находя, «какой именно ключ сжигает деньги».

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

Документация и учебные ресурсы стали полнее: release notes, курсы и Cookbook

В документации Claude API появились более системные примечания к релизам, охватывающие обновления API, консоли Claude и приложения Claude — удобно для ведения командного журнала изменений версий. Одновременно вышли официальные курсы по базовому использованию Claude API и инструментов — чтобы новичкам было проще быстро закрыть навыки вызовов, структурированного вывода JSON и т. п.

Если вы делаете retrieval-augmented generation, разметку ссылок или задачи классификации, можно сразу заглянуть в соответствующие руководства Claude Cookbook и сэкономить время на повторном «набивании шишек». В целом фокус этого обновления Claude API не в «фишках ради фишек», а в том, чтобы основательно сделать три вещи: длинный вывод, оценку и управление затратами.