Все названия моделей Anthropic API: актуальные ID и алиасы моделей Claude

Если вы искали все названия моделей Anthropic API, самый быстрый ответ таков: отображаемые имена Claude, актуальные ID моделей и датированные снимки — всё это похожие на допустимые метки, но в поле model должен попадать только точный идентификатор API. Anthropic использует человекочитаемые имена Claude для страниц продуктов, датированные ID моделей для воспроизводимых API-вызовов и алиасы для удобного обновления. Эти значения связаны, но не взаимозаменяемы.

Практическое правило простое: используйте точный ID модели, когда вам нужно воспроизводимое поведение; используйте алиас, когда вы осознанно хотите, чтобы Anthropic перевёл вас на более новый снимок; и никогда не копируйте маркетинговое название в API-запрос, не сверившись с официальным списком моделей.

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

Что такое название модели в Anthropic API?

Название модели в Anthropic API — это идентификатор, передаваемый в параметре model запроса к Messages API. Он сообщает Anthropic, какое семейство и снимок Claude должны обработать запрос.

Эти три формы легко перепутать:

Тип значения	Пример	Лучшее применение
Отображаемое имя	Claude Sonnet	Документация, пользовательский интерфейс продукта, разговоры с нетехническими читателями
Текущий ID модели	claude-sonnet-5	Новые интеграции, использующие модель из актуального списка моделей Anthropic
Датированный ID модели	claude-haiku-4-5-20251001	Тесты, регулируемые процессы, оценки и продакшен-развёртывания, требующие воспроизводимости

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

Названия моделей Claude и ID моделей Claude

Названия моделей Claude оптимизированы для людей. «Claude Sonnet» сообщает о продуктовом уровне, а «Claude Haiku» указывает на более быстрый и недорогой уровень. API требуется более точное значение, потому что семейство может иметь несколько снимков, правила региональной доступности и даты вывода из эксплуатации.

Датированный ID обычно включает:

1. Семейство Claude, например opus, sonnet или haiku.
2. Основное поколение модели.
3. Дату выпуска в формате YYYYMMDD.

Например, claude-haiku-4-5-20251001 идентифицирует снимок Haiku 4.5, выпущенный 1 октября 2025 года. Дата является частью идентификатора; это не временная метка запроса, и её не следует заменять текущей датой.

Некоторые каталоги моделей также содержат более короткие идентификаторы уровня семейства. Они удобны, если вы хотите поддерживаемую модель, не управляя датированным снимком самостоятельно. Обратная сторона в том, что управляемый провайдером указатель может изменить поведение после обновления, поэтому проверяйте семантику точного ID, указанного в текущем каталоге Anthropic.

Распространённые ID моделей Claude, которые вы можете встретить

Следующие API ID были перечислены как активные на странице актуальных моделей Anthropic 24 июля 2026 года. Эта таблица — ориентир на момент времени, а не постоянный реестр. Проверяйте документацию Anthropic перед использованием любого ID в новом развёртывании.

Семейство Claude	Текущий API ID	Типичная роль
Claude Opus 4.8	claude-opus-4-8	Сложные рассуждения и анализ с высокими ставками
Claude Sonnet 5	claude-sonnet-5	Универсальные продакшен-нагрузки
Claude Haiku 4.5	claude-haiku-4-5-20251001	Быстрая классификация, извлечение данных и короткие ответы
Claude Opus 4.7	claude-opus-4-7	Интеграции Opus последнего поколения, которые ещё не перешли на 4.8
Claude Sonnet 4.6	claude-sonnet-4-6	Интеграции Sonnet последнего поколения, которые ещё не перешли на Sonnet 5

Это идентификаторы, а не гарантия того, что модель доступна для каждой учётной записи Anthropic. Даже текущий ID может не сработать из-за разрешений учётной записи, региона, квоты или последующего изменения жизненного цикла. Датированные ID воспроизводимы, пока поддерживаются, но со временем они всё равно выводятся из эксплуатации.

Как выбрать между Opus, Sonnet и Haiku

Выбирайте по рабочей нагрузке, а не по самому длинному названию:

• Opus: Используйте, когда сложные рассуждения, длинный синтез или тонкие решения по инструментам оправдывают более высокую задержку или стоимость.
• Sonnet: Начните здесь для большинства продакшен-ассистентов, задач кодинга и структурированной генерации. Обычно это практический баланс качества и задержки.
• Haiku: Используйте для высоконагруженной маршрутизации, извлечения данных, модерации, коротких переписываний и других задач, где время ответа важнее максимальной глубины рассуждений.

Проведите небольшую оценку на репрезентативных промптах перед сменой семейства. Включите некорректные входные данные, длинный контекст, вызовы инструментов, JSON-вывод и поведение отката, которое ваше приложение использует при сбое запроса. Название модели, которое выглядит как замена «под ключ», всё равно может изменить формат вызовов инструментов или поведение в крайних случаях.

Используйте ID модели в запросе к Messages API

Значение model находится в JSON-теле. Оно не связано с заголовком версии API и с моделью, отображаемой в веб-приложении Claude.

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-5",
    "max_tokens": 512,
    "messages": [
      {
        "role": "user",
        "content": "Explain why API model IDs should be pinned in production."
      }
    ]
  }'

Заголовок anthropic-version описывает контракт API. Он не выбирает модель Claude. Держите эти два параметра независимыми в своей конфигурации, чтобы обновление клиентской библиотеки не меняло маршрутизацию моделей незаметно.

Для использования SDK задайте тот же идентификатор через метод создания сообщений клиента и храните его в конфигурации для конкретного окружения. Не помещайте API-ключ или ID модели в бандл браузера; серверная маршрутизация проще в обеспечении безопасности и тестировании.

Почему ID модели API может перестать работать

Ответ invalid_request_error или «model not found» обычно относится к одной из следующих категорий:

Вместо ID использовано отображаемое имя

Claude Sonnet — полезная метка, но не надёжное значение запроса. Замените её на ID или алиас из документации провайдера.

Снимок был выведен из эксплуатации

Датированные ID воспроизводимы, только пока провайдер их поддерживает. Следите за графиком устаревания, установите срок миграции и протестируйте замену до даты вывода из эксплуатации.

Учётная запись не имеет доступа к модели

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

Маршрутизатор ожидает имя, специфичное для провайдера

Шлюзы и OpenAI-совместимые API могут нормализовать названия моделей по-разному. Anthropic в настоящее время документирует claude-sonnet-5, тогда как другой провайдер может предоставлять значение с пространством имён или собственный алиас. Используйте каталог моделей шлюза и не предполагайте, что ID Claude переносится на любую конечную точку.

Использование рабочих процессов в стиле Claude через совместимую конечную точку

Если ваше приложение уже использует клиент OpenAI, слой совместимости может уменьшить объём работы по миграции. Novita LLM API предоставляет OpenAI-совместимую конечную точку для маршрутизации поддерживаемых моделей с открытым исходным кодом через привычную форму запроса chat-completions.

Это не значит, что каждый ID модели Claude там автоматически доступен. Явно указывайте маршрутизацию провайдера:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/v3/openai",
)

response = client.chat.completions.create(
    model="moonshotai/kimi-k2.5",
    messages=[
        {"role": "user", "content": "Summarize this support ticket in three bullets."}
    ],
)

print(response.choices[0].message.content)

Важный паттерн проектирования — карта «провайдер/модель», а не единая глобальная строка:

MODELS = {
    "anthropic": "claude-sonnet-5",
    "novita": "moonshotai/kimi-k2.5",
}

Это позволяет оценить модель Claude в сравнении с открытой альтернативой без переписывания бизнес-логики. Перед переходом сравнивайте структурированный вывод, вызовы инструментов, обработку контекста, задержку и режимы сбоев, а не только отображаемое имя или заголовок бенчмарка.

ID моделей в бэкендах и песочницах агентов

Агент обычно вызывает модель много раз: планирование, выбор инструментов, исправление кода и итоговый ответ. Помещайте идентификатор модели в конфигурацию бэкенда, а не в аргументы инструментов, управляемые пользователем. Записывайте выбранного провайдера и ID модели при каждом запуске, чтобы оценку можно было воспроизвести позже.

Когда агент выполняет сгенерированный код, держите маршрутизацию моделей отдельно от среды выполнения. Управляемая песочница агентов может изолировать файлы, пакеты и команды, пока конфигурация LLM API остаётся в сервисе агента. Такое разделение позволяет изменить алиас модели или протестировать закреплённый снимок без изменения образа песочницы.

Для продакшен-агентов добавьте три меры защиты:

1. Проверяйте сконфигурированную модель при запуске с помощью небольшого аутентифицированного запроса или проверки каталога провайдера.
2. Держите проверенный запасной ID и делайте активацию запасного варианта видимой в телеметрии.
3. Сохраняйте ID модели, версию API, версию промпта и схему инструментов вместе с результатами оценки.

FAQ

Какое название модели Claude является правильным для API?

Используйте точный ID модели из текущей документации Anthropic, например claude-sonnet-5 или датированный claude-haiku-4-5-20251001. Не используйте отображаемое имя вроде «Claude Sonnet» само по себе.

Лучше ли датированный ID модели Claude, чем алиас?

Ни один вариант не всегда лучше. Датированный ID предпочтителен для воспроизводимости и контролируемых развёртываний. Алиас предпочтителен, когда вы хотите поддерживаемый указатель семейства и у вас есть регрессионные тесты на обновления провайдера.

Можно ли использовать ID моделей Anthropic с OpenAI-совместимым API?

Только если эта конечная точка явно поддерживает и документирует ID. OpenAI-совместимость описывает интерфейс запросов; она не обещает идентичных каталогов моделей. Проверяйте поддерживаемые модели конечной точки и используйте её точное имя маршрутизации.

Как предотвратить поломку приложения из-за устаревания модели?

Закрепите проверенный ID, следите за уведомлениями Anthropic об устаревании, протестируйте замену до даты вывода из эксплуатации и храните значение модели в конфигурации, чтобы менять его без поставки изменений бизнес-логики.

Рекомендуемые статьи

• Упрощение интеграции LLM API для разработчиков
• Лучшая LLM API-платформа для смены провайдеров
• Что такое песочница AI-агента?

Источники

• Anthropic: обзор моделей
• Anthropic: справочник API моделей
• Anthropic: справочник Messages API
• Anthropic: устаревание моделей
• Novita AI: LLM API