Модели в API: российские модели и снятые с продаж

Дополнение к матрице совместимости. Актуальный список моделей с ценами всегда отдаёт GET /v1/models: у каждой модели есть идентификатор, прежние имена (aliases), признак обработки данных в России и, для снятых с продаж, преемник.

Российские модели

Модели, которые обрабатывают данные на серверах в России, в GET /v1/models помечены trialix.data_in_ru: true и trialix.data_country: "Россия". Вызываются по тем же адресам, что и остальные; запрос уходит провайдеру без плейсхолдеров обезличивания (x-trialix-anonymized: 0).

Ограничения: /v1/messages (формат Anthropic) принимает только модели claude-…; российские текстовые модели не принимают картинки на вход; temperature и top_p у YandexGPT и Alice AI LLM принимаются.

Чат, OpenAI-совместимый формат

curl https://api.trialix.ru/v1/chat/completions \
  -H "Authorization: Bearer $TRIALIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "yandexgpt-5.1-pro",
    "messages": [{"role": "user", "content": "Составь ответ на претензию по срокам поставки"}]
  }'

Поток и инструменты (function calling) работают как у остальных моделей:

curl https://api.trialix.ru/v1/chat/completions \
  -H "Authorization: Bearer $TRIALIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aliceai-llm-flash",
    "stream": true,
    "stream_options": {"include_usage": true},
    "messages": [{"role": "user", "content": "Классифицируй обращение: «не пришёл закрывающий документ за август»"}]
  }'

Responses API

curl https://api.trialix.ru/v1/responses \
  -H "Authorization: Bearer $TRIALIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "aliceai-llm", "input": "Кратко: чем отличается аванс от задатка"}'

Эмбеддинги

curl https://api.trialix.ru/v1/embeddings \
  -H "Authorization: Bearer $TRIALIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "yandex-embeddings-v2", "input": ["Регламент закупок", "Порядок согласования договоров"]}'

Ответ - векторы по 768 значений; строки уходят в Яндекс по одной, поэтому большой массив индексируется медленнее, чем у text-embedding-3-small.

Картинки

curl https://api.trialix.ru/v1/images/generations \
  -H "Authorization: Bearer $TRIALIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "yandex-art", "prompt": "Иллюстрация к новости компании о запуске склада", "aspect_ratio": "16:9"}'

nano-banana-2.1 - Nano Banana 2.1 (1K, 2K, 4K: 10 / 15 / 33 ₽), yandex-art - YandexART 2.0, alice-art - Alice AI ART; принимается и запись с префиксом yandex/yandex-art. Только генерация (/v1/images/edits эти модели не принимает), один результат за запрос, JPEG около 1 Мп, соотношения 1:1, 16:9, 9:16, 4:3, 3:4, промпт до 500 знаков.

Снятые с продаж модели

Когда провайдер выпускает преемника, модель снимается с продаж: в чате, политиках и агентах её нет, а в GET /v1/models она остаётся с полями:

{
  "id": "claude-sonnet-5",
  "object": "model",
  "trialix": {
    "retired": true,
    "successor": "claude-sonnet-5-5",
    "provider_shutdown": null,
    "provider_shut_down": false,
    "retire_reason": "Anthropic выпустила Claude Sonnet 5.5: та же цена, контекст 1M"
  }
}

Поведение по прежнему идентификатору:

1. Пока провайдер обслуживает модель, запрос уходит ей. В ответе (/v1/chat/completions, /v1/responses, /v1/messages, GET /v1/models/{id}) заголовки deprecation: true, sunset: <дата отключения у провайдера, RFC 7231, если известна> и x-trialix-model-successor: <идентификатор преемника>.
2. После даты provider_shutdown (или если провайдер перестал отвечать) запрос по старому идентификатору исполняет преемник; заголовки остаются.
3. Прежние имена у провайдера тоже принимаются: claude-fable-5-1, claude-haiku-4-5-20251001, gpt-5.6-terra, gpt-5.6-sol, gemini-3.6-flash, gemini-3.1-pro-preview, grok-4.6, deepseek-v4.1-flash, qwen3.6-35b-a3b, anthropic/claude-sonnet-5-5.
4. Медиа-модели снимаются так же: после даты снятия запрос /v1/images/generations или /v1/media/* с прежним model исполняет преемник, цена - преемника; до даты модель работает как обычно.

curl -sD - -o /dev/null https://api.trialix.ru/v1/models/claude-sonnet-5 \
  -H "Authorization: Bearer $TRIALIX_API_KEY" | grep -i -E '^(deprecation|sunset|x-trialix-model-successor):'
# deprecation: true
# x-trialix-model-successor: claude-sonnet-5-5

Снятые 30.09.2026 и их преемники:

Разрешённые модели ключей компании переводятся на преемника автоматически, администраторы получают письмо «Модели заменены на преемников в Trialix». Переключайте интеграции на новый идентификатор при первой возможности.