Токены, контекст и лимиты

Новые модели могут иначе считать токены нейросетей: менять скорость генерации, потребление context window, поведение tool calling и максимальный размер ответа. Даже если payload остается прежним, проверьте max_tokens, timeout, retry policy и лимиты бюджета. Для длинных документов и агентских сценариев особенно важны context window, streaming и стоимость output-токенов.

Сравнение старых и новых endpoint

Практические шаги

1. Найдите устаревшие model IDs. Проверьте репозиторий, CI/CD-переменные, Docker-файлы, Terraform, .env-шаблоны и no-code-интеграции. Ищите claude-sonnet-4-20250514 и claude-opus-4-20250514.
2. Вынесите модель в конфигурацию. Не хардкодьте model внутри бизнес-кода. Лучше использовать переменные LLM_MODEL, KOSAREVA_BASE_URL и KOSAREVA_API_KEY.
3. Замените retired-модель на активную. Для Sonnet-сценариев начните с claude-sonnet-4-6. Для Opus-сценариев протестируйте claude-opus-4-8. Не меняйте сразу все окружения: сначала dev, затем staging, потом production.
4. Проверьте payload. Убедитесь, что messages, max_tokens, temperature, stream и response_format поддерживаются вашим endpoint. Если используется streaming, протестируйте его отдельно.
5. Запустите smoke-тест через curl. Пример для OpenAI-совместимого endpoint:

export KOSAREVA_BASE_URL="https://api.kosareva.cloud/v1"
export KOSAREVA_API_KEY="your_api_key"

curl -X POST "$KOSAREVA_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $KOSAREVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "system", "content": "Ты проверяешь миграцию Claude API."},
      {"role": "user", "content": "Верни JSON с полями status и model."}
    ],
    "max_tokens": 256,
    "temperature": 0,
    "response_format": {"type": "json_object"},
    "stream": false
  }'

6. Проверьте интеграцию на Python. Этот пример удобно добавить в CI или в скрипт pre-deploy:

import os
import requests

base_url = os.getenv("KOSAREVA_BASE_URL", "https://api.kosareva.cloud/v1")
api_key = os.environ["KOSAREVA_API_KEY"]

payload = {
    "model": "claude-opus-4-8",
    "messages": [
        {"role": "system", "content": "Отвечай кратко и структурно."},
        {"role": "user", "content": "Проверь миграцию API: верни три риска замены модели."}
    ],
    "max_tokens": 512,
    "temperature": 0.2,
    "stream": False,
}

response = requests.post(
    f"{base_url}/chat/completions",
    headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
    json=payload,
    timeout=30,
)
response.raise_for_status()
print(response.json()["choices"][0]["message"]["content"])

7. Включите канареечный релиз и мониторинг. Направляйте 5–10% трафика на новую модель, сравнивайте latency, стоимость токенов, процент ошибок и качество ответов. Только после стабильных метрик переключайте 100% трафика.

Типичные ошибки

• Меняют только одну модель. В больших проектах model ID часто дублируется в нескольких сервисах, cron-задачах и библиотеках.
• Не проверяют structured output. Новая модель может иначе соблюдать JSON-схему, поэтому тесты на формат обязательны.
• Забывают про лимит бюджета. Более мощная модель может стоить дороже на output-токенах, особенно в длинных агентских сценариях.
• Игнорируют latency. Opus-модели часто дают более глубокие ответы, но могут быть медленнее Sonnet-моделей.
• Оставляют доступ через нестабильный VPN. Для production-интеграций лучше использовать стабильный endpoint, мониторинг и резервный провайдер.

Частые вопросы

Вопрос: Почему запросы с claude-sonnet-4-20250514 и claude-opus-4-20250514 перестали работать?

Ответ: Anthropic пометила эти model ID как retired с 15 июня 2026 года. После даты retirement API возвращает ошибку, потому что старые модели больше недоступны. Нужно заменить model ID на активную версию и протестировать промпты.

Вопрос: Какой model ID использовать вместо Claude Sonnet 4?

Ответ: Для большинства задач начните с claude-sonnet-4-6. Он активен, подходит для ежедневных агентских задач, кода и обработки документов. Если старый сценарий был сильнее завязан на Opus, параллельно протестируйте claude-opus-4-8.

Вопрос: Нужно ли менять формат запроса при миграции?

Ответ: Обычно нет. Если вы уже используете OpenAI-совместимый endpoint, чаще всего меняется только поле model, base_url и ключ провайдера. Но проверьте параметры streaming, tools и max_tokens, потому что поведение новых моделей может отличаться.

Вопрос: Как проверить, где в коде зашит старый endpoint?

Ответ: Ищите в репозитории и CI-переменных старые model ID: claude-sonnet-4-20250514 и claude-opus-4-20250514. Добавьте автоматический grep или тест, который падает при обнаружении retired-моделей.

Вопрос: Можно ли подключить Claude из России без VPN?

Ответ: Да, через провайдера с OpenAI-совместимым API, например kosareva.cloud. Это позволяет оплачивать доступ к зарубежным LLM в рублях и вызывать endpoint нейросети без обхода блокировок, если сервис доступен из РФ.

Заключение

Отключение Claude Sonnet 4 и Claude Opus 4 — хороший пример того, почему AI API нельзя строить на жестко зашитых model IDs. Правильная миграция начинается с инвентаризации endpoint, продолжается заменой модели и проверкой payload, а заканчивается канареечным релизом и мониторингом стоимости токенов.

Если ваш продукт зависит от Claude, OpenAI или других зарубежных LLM, держите model ID в конфигурации, тестируйте замены заранее и используйте стабильный OpenAI-совместимый API. Для команд из РФ это особенно важно: kosareva.cloud дает доступ к зарубежным моделям из России за рубли без VPN, с договором и закрывающими документами.

Источники для проверки: Anthropic Model deprecations и Anthropic Pricing.