Последняя версия семейства
Один слаг ~author/family-latest всегда указывает на новейшую модель линейки. Код не меняете: выходит новая версия — следующие запросы сами идут в неё.
Это удобно для ассистентов и внутренних инструментов, где важнее «свежий Claude Opus», а не конкретный номер релиза. Для тестов и воспроизводимости берите id из каталога.
Как вызвать
В поле model передайте алиас:
curl https://api.aitunnel.ru/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-aitunnel-xxx" \
-d '{
"model": "~anthropic/claude-opus-latest",
"messages": [
{ "role": "user", "content": "Скажи интересный факт" }
]
}'Работает в /chat/completions, /responses и /messages.
Формат
~author/family-latest
| Часть | Смысл | Пример |
|---|---|---|
~ | это алиас, не конкретная версия | ~ |
author | кто выпускает линейку | anthropic, openai, google |
family | семейство моделей | claude-opus, claude-sonnet |
latest | всегда самая новая подходящая модель | latest |
Если у семейства нет доступной модели, запрос вернёт ошибку — в другую линейку алиас не уйдёт.
Какие есть
| Автор | Алиас | Линейка |
|---|---|---|
| Anthropic | ~anthropic/claude-opus-latest | Claude Opus |
| Anthropic | ~anthropic/claude-sonnet-latest | Claude Sonnet |
| Anthropic | ~anthropic/claude-haiku-latest | Claude Haiku |
| Anthropic | ~anthropic/claude-fable-latest | Claude Fable |
| OpenAI | ~openai/gpt-latest | GPT |
| OpenAI | ~openai/gpt-mini-latest | GPT Mini |
~google/gemini-flash-latest | Gemini Flash | |
~google/gemini-pro-latest | Gemini Pro | |
| DeepSeek | ~deepseek/deepseek-v4-flash-latest | DeepSeek V4 Flash |
| Moonshot | ~moonshotai/kimi-latest | Kimi |
| xAI | ~x-ai/grok-latest | Grok |
| Z.ai | ~z-ai/glm-latest | GLM |
| Z.ai | ~z-ai/glm-flash-latest | GLM Flash |
Новые линейки появляются по мере релизов. Несуществующий слаг вернёт ошибку.
Что в ответе
Поле model — конкретная версия, которая ответила, а не алиас. По ней же считается стоимость и строится статистика.
{
"id": "chatcmpl-...",
"model": "anthropic/claude-opus-5",
"choices": [
{
"message": {
"role": "assistant",
"content": "..."
}
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 85,
"total_tokens": 97
}
}Записывайте это значение, если нужно понять, на какую версию уехал запрос после смены таргета.
Цена
Списание — по ставке той модели, в которую алиас резолвится сейчас. Когда линейка обновляется, цена и возможности меняются вместе с таргетом. Итог смотрите в usage.cost_rub.
Пресеты и запасные модели
Алиас можно поставить в список моделей пресета и в массив models. Имя самого пресета остаётся без слеша — слаг живёт только в списке моделей.
Если у ключа включён белый список, в нём должен быть точный слаг (~anthropic/claude-opus-latest), а не каталожное имя. См. API-ключи.
Когда лучше зафиксировать версию
- Регрессионные тесты и бенчмарки, где ответ должен быть сравнимым.
- Продовые сценарии, где нельзя внезапно сменить поведение или цену.
- Нужна конкретная, а не «вторая свежесть»: у алиаса нет отката и нет «предыдущей» версии.
В этих случаях вызывайте id из каталога — claude-opus-5, claude-sonnet-5. Тот же слаг, что пришёл в model ответа, тоже можно отправить повторно: он уже конкретный.