Введение
Claude Opus 4.5 — чат-модель линейки Opus от Anthropic, здесь она доступна как один совместимый с OpenAI эндпоинт /v1/chat/completions. В окно на 198 000 токенов дословно помещаются десятки реплик истории, а один ответ может занимать до 32 768 токенов — хватает на целую сцену или короткую главу.
Помимо уровня рассуждения low, medium или high, модель принимает temperature (от 0 до 1, по умолчанию 1) и top_p. Сообщения — текст и изображения, к запросу можно подключить до 128 инструментов, а ответ по желанию приходит потоком через Server-Sent Events.
Ключевые возможности и особенности
198 000 токенов, прочитанных так, как они написаны
Через тридцать реплик ролевой игры первой сдаёт память, а не текст: откуда персонаж родом, на что она согласилась, какую черту поклялась не переступать. 198 000 токенов держат эту историю в запросе дословно, поэтому модель читает исходные реплики, а не пересказ, в котором уже нет самых важных.
Сэмплирование, которым по-прежнему можно управлять
temperature принимает значения от 0 до 1, по умолчанию 1, а top_p — от 0,01 до 1. Понижайте temperature для проверки согласованности, где нельзя ничего придумывать, и оставляйте 1 для диалогов, которые должны удивлять. Уровень рассуждения — отдельная настройка: low, medium или high.
Структурированный вывод через принудительный вызов инструмента
У этого эндпоинта нет response_format, поэтому машиночитаемый вывод идёт через инструменты: до 128 определений функций на запрос, tool_choice — auto, none, required или конкретная функция. Опишите JSON-схему в параметрах инструмента, вызовите его принудительно и проверьте вернувшиеся аргументы.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
messages | Да | Упорядоченные реплики диалога. Содержимое — строка или массив частей text и |
max_tokens | Нет | Ограничивает ответ значением 32 768 — примерно шестая часть окна чтения. По умолчанию 4 096; поднимите перед тем, как писать главу. |
reasoning_effort | Нет | low, medium или high, по умолчанию medium. Поднимайте, когда ответу нужно свести детали до того, как модель начнёт писать. |
stop | Нет | До 4 последовательностей — строкой или массивом. Ответ обрывается, как только модель пишет одну из них, а совпавший текст не возвращается. Не менее 1 символов · Не менее 1 элементов · Не более 4 элементов |
temperature | Нет | От 0 до 1, по умолчанию 1. Держите на 0 всякий раз, когда ответ разбирает код, и не трогайте, когда вещь уже нашла свой голос. |
top_p | Нет | От 0,01 до 1. В одном сравнении меняйте его либо temperature, но не оба. |
tools | Нет | До 128 описаний функций на запрос. Не более 128 элементов |
parallel_tool_calls | Нет | true или false, по умолчанию true: модель может запросить несколько вызовов инструментов за один ход. По умолчанию: |
tool_choice | Нет | auto, none, required или объект с именем конкретной функции. |
Стоимость
Ввод $4.50 / Вывод $22.50 за 1 млн токенов
Сценарии использования
Чат с персонажем, который не выходит из роли
Карточку персонажа отправьте в системном сообщении, а текущую переписку — в messages. Даже через десятки реплик модель может процитировать обещание из третьей, потому что третья реплика всё ещё в запросе.
Продолжения длиной в сцену
32 768 токенов — это примерно длинная сцена или короткая глава. Попросите следующую сцену, подняв max_tokens выше стандартных 4 096, и она придёт одним куском, а не тремя фрагментами, сшитыми вручную.
Состояние сюжета, которое сохранит ваше приложение
Опишите инструмент вроде update_story_state с полями для места действия, отношений и незакрытых линий, вызывайте его принудительно раз в несколько реплик и сохраняйте аргументы в приложении. Текст и состояние рождаются из одного контекста, поэтому не противоречат друг другу.
Руководство по промптам и практические советы
Персона и границы — в системном сообщении
Происхождение, манера речи, жёсткие границы, лицо и время повествования должны быть в системном сообщении, которое никогда не выпадает из запроса. В пользовательском сообщении оставляйте только текущую реплику — тогда при последующей обрезке уходит переписка, а не персонаж.
Поднимите max_tokens до того, как просить объём
Стандартных 4 096 токенов хватает на несколько страниц. Для целой сцены задайте max_tokens явно, вплоть до 32 768: ответ, оборванный посреди абзаца, спасти труднее, чем тот, что с самого начала задумывался коротким.
Знайте, где кончается окно
Читает модель примерно вшестеро больше, чем пишет, поэтому запрос воспроизвести длинный вход сначала упрётся в предел ответа, а max_tokens больше 32 768 не пройдёт валидацию. Части с видео и аудио отклоняются, а в 198 000 токенов входят сразу системный промпт, история и все результаты инструментов.
Быстрый старт API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "anthropic/claude-opus-4.5/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
