Как использовать API Claude Haiku 5.5: полное руководство разработчика

TLDR Claude Haiku 5.5 назван самой дешевой, самой быстрой и самой способной небольшой моделью, когда‑либо выпущенной. Создана для высокообъемных, чувствительных к задержке нагрузок — таких как классификация, извлечение, маршрутизация, суммаризация и задачи субагентов; предлагает контекстное окно на 1 миллион токенов, до 128K выходных токенов и адаптивное мышление с регулируемыми уровнями усилий.

В среднем эксплуатация стоит примерно на 75% дешевле, чем у Haiku 4.5, при этом модель демонстрирует большие улучшения на бенчмарках агентности и компьютерного использования. Доступ через официальное Claude API (claude-haiku-5-5), Amazon Bedrock, Google Cloud, Microsoft Foundry или оптимизированные по стоимости шлюзы, такие как CometAPI (начиная с $0.08 / $0.40).

Ключевые выводы

• Выпуск и позиционирование: запущена 7 октября 2026 года как небольшая высокопроизводительная модель в семействе Claude 5.5 — идеально подходит для задач реального времени, обработки документов и делегированных шагов агентов.
• Основные характеристики: контекст 1M токенов, максимум 128K на вывод (300K через Batch API beta), адаптивное мышление (по умолчанию средний уровень усилий), вход: текст + изображение → выход: текст, срез знаний — июнь 2026 года.
• Преимущество по цене: $0.10 за вход / $0.50 за выход за миллион токенов для запросов до 100K (≈ на 90% дешевле Haiku 4.5 для большинства запросов); более высокий тариф выше 100K. Чтение из кеша — от $0.01. CometAPI предлагает ≈20% более низкие Standard‑ставки.
• Прыжок в производительности: крупные выигрыши против Haiku 4.5 (например, OSWorld 72.4% vs 15.7%, Terminal-Bench 39.2% vs 0%, GDPval-AA 1620 vs 735 Elo), при этом во многих тестах конкурентоспособна с GPT-6 Luna или превосходит его.
• Возможности для разработчиков: параметр усилий (low–max), кеширование промптов, Batch API (скидка 50%), использование компьютера/браузера (поддержка SDK в бета-версии). Параметры temperature/top_p/top_k должны быть опущены, иначе произойдет ошибка 400.

Что такое Claude Haiku 5.5 и почему это важно в 2026 году

Claude Haiku 5.5 — последняя разработка Anthropic в легковесном сегменте семейства Claude. В отличие от более дорогих Opus 5.5 и Sonnet 5.5, оптимизированных для сложного рассуждения и долгоживущих агентов, Haiku 5.5 целенаправленно создан для высокообъемных, чувствительных к стоимости и задержке рабочих нагрузок. Anthropic описывает его как «самую дешевую, самую быструю и самую способную небольшую модель, которую мы когда‑либо выпускали».

Типичные производственные сценарии:

• Классификация тикетов и маршрутизация в службе поддержки
• Извлечение полей и суммаризация из длинных документов
• Компактизация истории диалога для более крупных моделей
• Запросы в стиле баз данных и задачи со структурированными данными
• Быстрые субагенты, которые обрабатывают узкие шаги по коду, инструментам или браузеру, пока более сильная модель оркестрирует процесс

Поскольку она значительно дешевле и быстрее предшественницы, при этом закрывает значительную часть разрыва качества в практических агентных задачах, многие команды переразрабатывают конвейеры так, чтобы Haiku 5.5 обрабатывала большинство запросов, а сложные кейсы эскалировались на Sonnet или Opus. Ранние отзывы клиентов из Asana, HubSpot, Box и других отмечают снижение задержки на 30%+ и измеримое повышение точности на внутренних высокообъемных оценках.

Технические характеристики Claude Haiku 5.5

Источник: обзор моделей Anthropic и документация платформы.

Большее окно контекста и повышенные лимиты на вывод, вместе с адаптивным мышлением, делают Haiku 5.5 гораздо более пригодной для реальных производственных систем, чем ранние небольшие модели, которые требовали агрессивной усечки или фиксированного бюджета на «мышление».

Ответы и проверки завершения

Считывайте блоки контента по типам, а не предполагайте, что content[0] — видимый ответ. Перед принятием вывода проверяйте stop_reason: max_tokens указывает на усеченную генерацию, а отказ требует явного прикладного ответа. Для запросов с инструментами обрабатывайте блоки tool-use и возвращайте результаты инструментов в нативном формате, а не воспринимайте их как завершенный текстовый ответ.

Что изменилось по сравнению с Claude Haiku 4.5 API?

Изменения емкости, поведения и цен

В этом сравнении цены Haiku 5.5 применяются к промптам до 100,000 токенов; более длинные промпты стоят дороже. Это ставки Anthropic Standard, а не ставки CometAPI. Сравнение — отправная точка для роутинга, а не утверждение, что модели работают идентично.

Для интеграций Haiku 4.5 ключевые изменения реализации — адаптивное мышление вместо ручного бюджета, управление усилиями, выборочный разбор блоков контента и обновленные подсчеты токенов. Один и тот же текст может потреблять примерно на 30% больше входных токенов. Пересчитайте репрезентативные промпты, а не переиспользуйте оценки токенов Haiku 4.5. Раздел миграции превращает эти изменения в чек‑лист внедрения.

Сообщаемые улучшения в бенчмарках

Anthropic приводит приведенные выше оценки в своем резюме бенчмарков запуска. Это опубликованные результаты оценок, а не живые тесты примеров CometAPI в этом руководстве. Показатель OSWorld 72.4% — это частичный зачет, а не строгий уровень завершения задач.

Системная карта Haiku 5.5 описывает условия оценки. Стандартные оценки Haiku 5.5 используют адаптивное мышление на max effort и дефолтную выборку, если не указано иное; продуктовый дефолт — medium. OSWorld использует 82 офлайн‑задачи, без доступа в интернет, разрешение 1080p и лимит в 500 действий. Terminal-Bench 4.0 использует Claude Code в bare‑режиме, без исходящего интернета и 10 прогонов на задачу для Haiku 5.5; настройка Sonnet отличается. Строки HLE и Chartography выше — без инструментов. GDPval-AA сообщает рейтинг Elo из оценок Artificial Analysis. При сравнении результатов сопоставляйте соответствующий стенд, effort и настройки инструментов.

Оригинальная графика OSWorld от Anthropic показывает связь между effort, стоимостью на задачу и оценкой с частичным зачетом. Она не измеряет задержку API и не гарантирует такое же поведение на вашей задаче.

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

Таблица бенчмарков и приведенная графика сохранены как сравнения моделей. Это результаты оценок, а не живые тесты примеров CometAPI. Используйте ту же выборку задач, effort и настройки инструментов при оценке приложения; бенчмарк не устанавливает задержку шлюза или ваш собственный уровень успеха.

Как использовать Claude Haiku 5.5 API через CometAPI

Создайте ключ и выберите нативный маршрут

Создайте аккаунт CometAPI, подтвердите доступ к claude-haiku-5-5 и сгенерируйте серверный API‑ключ. Установите COMETAPI_KEY в окружении. Держите ключ вне системы контроля версий и браузерного кода. Ключи Anthropic и CometAPI принадлежат разным провайдерам; используйте ключ CometAPI для каждого примера в этом обновленном руководстве.

export COMETAPI_KEY="your_cometapi_api_key"
pip install --upgrade anthropic

$env:COMETAPI_KEY="your_cometapi_api_key"

CometAPI поддерживает нативные Messages и формат блоков контента Claude. Используйте Anthropic SDK с корневым базовым URL CometAPI. Нативный Messages — предпочтительный маршрут в этом руководстве для специфичных для Claude «мышления» и блоков контента. Совместимый маршрут Chat Completions — опция для существующего приложения в стиле OpenAI. Подтвердите поддержку расширенных полей на конкретном маршруте шлюза.

Отправьте минимальный запрос и проверьте результат

curl https://api.cometapi.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $COMETAPI_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 2048,
    "output_config": {"effort": "low"},
    "messages": [{"role": "user", "content": "Summarize three AI uses in customer support."}]
  }'

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com",
    timeout=60.0,
    max_retries=2,
)

response = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=2048,
    output_config={"effort": "low"},
    messages=[{"role": "user", "content": "Classify this ticket: I cannot log in."}],
)
if response.stop_reason != "end_turn":
    raise RuntimeError(f"Unaccepted completion: {response.stop_reason}")
print("".join(block.text for block in response.content if block.type == "text"))
print(response.usage)

Сохраните пример Python как example.py и запустите python example.py. Признак успешной проверки — завершенный ответ с видимым текстом и полями usage. Ошибка аутентификации означает, что ключ нужно проверить; ошибка модели/маршрута означает, что нужно проверить ID модели, endpoint или доступ аккаунта.

Используйте тот же нативный формат из JavaScript

npm install @anthropic-ai/sdk

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.COMETAPI_KEY,
  baseURL: "https://api.cometapi.com",
  timeout: 60_000,
  maxRetries: 2,
});
const response = await client.messages.create({
  model: "claude-haiku-5-5",
  max_tokens: 2048,
  output_config: {effort: "low"},
  messages: [{role: "user", content: "Extract product, quantity and price: 3 laptops at $900 each."}],
});
if (response.stop_reason !== "end_turn") {
  throw new Error("Unaccepted completion: " + response.stop_reason);
}
for (const block of response.content) {
  if (block.type === "text") console.log(block.text);
}

Используйте поддерживаемую версию Node.js. Сохраните файл как example.mjs, установите COMETAPI_KEY и запустите node example.mjs. Зафиксируйте версию SDK, которую вы валидировали для продакшна.

Адаптация существующего приложения, совместимого с OpenAI

Если ваше приложение уже использует Chat Completions, установите пакет openai и настройте отдельный клиент ниже. Этот маршрут возвращает choices вместо нативных блоков контента. Держите разбор, специфичный для маршрута, отдельно и протестируйте «мышление», изображения и инструменты, прежде чем полагаться на перевод шлюза.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)
response = client.chat.completions.create(
    model="claude-haiku-5-5",
    max_tokens=2048,
    messages=[
        {"role": "system", "content": "Be concise and helpful."},
        {"role": "user", "content": "Explain API rate limits."},
    ],
)
print(response.choices[0].message.content)

Отправка изображений в Claude Haiku 5.5 API

Используйте изображение вместе с инструкцией, которая уточняет, какие свидетельства и какой вывод вам нужны. Официальный интерфейс для зрения принимает блоки изображения с данными base64, URL изображения или ссылкой на поддерживаемый загруженный файл. В этом примере читается локальный PNG, помещается перед вопросом и запрашиваются значения, которые можно проверить по источнику.

Проанализируйте реальный локальный PNG через нативное Anthropic Messages API.

import os
import base64
from pathlib import Path
import anthropic

# Replace dashboard.png with a real PNG file you are authorized to analyze.
image_data = base64.b64encode(Path("dashboard.png").read_bytes()).decode("ascii")
anthropic_client = anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])
response = anthropic_client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=2048,
    output_config={"effort": "low"},
    messages=[{
        "role": "user",
        "content": [
            {"type": "image", "source": {
                "type": "base64", "media_type": "image/png", "data": image_data
            }},
            {"type": "text", "text": (
                "Read the visible dashboard metrics. List anomalies with their "
                "labels and values, and state when text is unreadable."
            )},
        ],
    }],
)
for block in response.content:
    if block.type == "text":
        print(block.text)

Используйте MIME‑тип, соответствующий фактическому файлу. Проверьте читаемость, размеры изображения и ограничения на размер запроса перед отправкой; избегайте отправки высокоразрешенных медиа, не помогающих задаче. Для CometAPI замените ключ и корневой базовый URL, как показано в примере Messages, и подтвердите поддержку изображений на конкретном маршруте.

Управление рассуждениями Claude Haiku 5.5

Haiku 5.5 по умолчанию использует адаптивное «мышление». Официальная конфигурация мышления объясняет, когда допускается отключение и как возвращаются блоки мышления. Задайте effort через output_config.effort; не переиспользуйте устаревший budget_tokens.

Настройте адаптивное мышление с низким effort.

import osimport anthropic​anthropic_client = anthropic.Anthropic(    api_key=os.environ["ANTHROPIC_API_KEY"],)​response = anthropic_client.messages.create(    model="claude-haiku-5-5",    max_tokens=4096,    thinking={"type": "adaptive"},    output_config={"effort": "low"},    messages=[{"role": "user", "content":        "Classify as billing, technical, or account: cannot log in."}],)for block in response.content:    if block.type == "text":        print(block.text)

Разработчики могут отключать мышление на уровнях low, medium и high, но не на xhigh или max. Мышление потребляет оплачиваемые выходные токены и бюджет max_tokens, даже если его текст скрыт. Пустое поле thinking все равно может нести сигнатуру; это не доказывает, что рассуждения не выполнялись. Сохраняйте возвращенные блоки контента без изменений при продолжении диалогов с инструментами.

Пример запроса с отключенным мышлением

Отправьте нативное тело запроса с отключенным мышлением.

{  "model": "claude-haiku-5-5",  "max_tokens": 1024,  "thinking": {"type": "disabled"},  "output_config": {"effort": "low"},  "messages": [    {"role": "user", "content": "Return sentiment only: positive, neutral, negative."}  ]}

Потоковая передача ответов Claude Haiku 5.5

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

Стримьте видимый текст с помощью Anthropic Python SDK.

import osimport anthropic​anthropic_client = anthropic.Anthropic(    api_key=os.environ["ANTHROPIC_API_KEY"],)with anthropic_client.messages.stream(    model="claude-haiku-5-5",    max_tokens=4096,    output_config={"effort": "low"},    messages=[{"role": "user", "content": "Explain API caching."}],) as stream:    for text in stream.text_stream:        print(text, end="", flush=True)

Цены Claude Haiku 5.5 API

Сравнение ставок за токены и диапазонов длины промпта

Ставки проверены 8 октября 2026 года. Таблица сравнивает Anthropic Standard pricing с опубликованными ставками CometAPI, в USD за миллион токенов. Диапазон определяется длиной промпта: до 100,000 токенов против более 100,000. Более длинные запросы используют соответствующие ставки более высокого диапазона, а не надбавку только на превышающие токены. Биллинг аккаунта, использование кеша и необязательные инструменты должны сверяться отдельно.

Снимок ставок из исходной статьи сохранен выше. Проверьте текущий листинг CometAPI и биллинг аккаунта перед покупкой или внедрением; стартовая ставка на вход в листинге — не полная котировка для каждого диапазона длины промпта, операций кеша или опциональных инструментов.

Пример: стоимость 100,000 запросов поддержки

Допустим, 100,000 запросов в месяц, каждый с 2,000 входными токенами и 300 оплачиваемыми выходными токенами, включая любое сгенерированное мышление. Каждый промпт попадает в диапазон до 100K. Исключены кеширование, расходы на инструменты и ретраи.

При этих допущениях иллюстративная разница составляет $7 в месяц, или 20%. Фактические производственные расходы зависят от длины запросов, скрытого мышления, кеширования и поведения ретраев.

Используйте текущие подсчеты токенов модели в расчете. Стоимость = входные токены × применимая ставка входа / 1,000,000 + оплачиваемые выходные токены × применимая ставка выхода / 1,000,000, плюс отдельные расходы на кеш, инструменты и ретраи. Токены мышления входят в оплачиваемый выход.

Снижение затрат без потери качества принятого задания

Не выбирайте автоматически самый низкий effort. Более дешевый отдельный вызов может увеличить общие расходы, если приводит к большему числу ретраев. Оценивайте точность, p50/p95 задержку, использование токенов и стоимость на успешную задачу.

Для кеширования промптов переиспользуйте стабильный префикс и отслеживайте создание кеша и чтения из кеша, а не предполагаете попадание. В Claude API у Haiku 5.5 минимальный кешируемый промпт — 512 токенов. Изменение effort может инвалидировать кешированные префиксы; сохраняйте настройки стабильными в рамках разговора. Окно контекста 1M — потолок емкости, а не рекомендация отправлять каждый документ на каждом шаге.

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

Руководство по миграции с Claude Haiku 4.5 на Haiku 5.5

Обновите интеграцию и формат запроса

Для маршрута CometAPI, используемого здесь, сохраните COMETAPI_KEY и нативный базовый URL, меняя ID модели и конфигурацию запроса. Замените устаревшее включенное «мышление» с бюджетом на адаптивное мышление и effort. Уберите assistant prefilling и опустите параметры сэмплинга. Сохраняйте различие между нативным массивом контента Claude и ответом choices совместимого маршрута.

Сохраняйте состояние и пересчитывайте бюджеты

Официальное руководство по миграции Haiku 5.5 сообщает примерно на 30% больше входных токенов для идентичного текста, чем у Haiku 4.5. Пересчитайте репрезентативные промпты и перенастройте лимиты перед переводом трафика. Возвращенные блоки мышления работают только в аккаунте, который их сгенерировал, или связанном аккаунте; смена аккаунта может тихо отбрасывать эти блоки. Сохраняйте префикс разговора как «только добавление», а не модифицируйте более ранние сообщения после генерации. Инспектируйте stop_reason, включая max_tokens и refusal, и обрабатывайте их явно до принятия вывода.

Пересчитайте репрезентативные промпты на целевой модели и перенастройте max_tokens, ограничения задержки и оценки стоимости запроса. Тестируйте сохраненные диалоги в аккаунте и на маршруте шлюза, где они будут воспроизводиться; не предполагайте, что подписанные блоки мышления переносимы между несвязанными аккаунтами или переписанными префиксами разговоров.

Заключение

Claude Haiku 5.5 — подлинная точка перегиба для экономичных высокопроизводительных ИИ. Обеспечивая существенно лучшую агентность и компьютерное использование примерно за одну десятую от прежней цены Haiku на большинстве запросов, Anthropic сделала практичным масштабное внедрение способных небольших моделей. Независимо от того, вызываете ли вы официальное API, используете Amazon Bedrock или применяете унифицированный шлюз вроде CometAPI для дополнительной экономии и операционной простоты, сочетание скорости, возможностей и цены открывает новые продуктовые возможности, ранее экономически нецелесообразные.