Примечание автора: в ноябре 2026 года новые модели выходят одна за другой. В этой статье — о том, как менять модель на одном входе, подключаться по эндпоинтам и вести раздельный учёт затрат по каждому каналу.
Прошло всего три недели ноября, а Google уже выпустила три модели Gemini 4: 10 ноября — Carbon, 12 ноября — Hydrogen, 18 ноября — Neon. В новостях то и дело появляются новые модели для изображений, кодинга и других направлений. Для разработчика, который хочет попробовать новую модель, сложность не в том, чтобы написать код вызова, а в том, что у каждого вендора свой SDK, своя аутентификация и своя логика биллинга. Вот более простой путь: один вход для смены модели, счета — по каналам отдельно.
Это не рекламный список «всех новинок сразу». Модели, о которых пишут в новостях, и модели, которые уже можно вызывать на платформе, здесь идут отдельно. Например, MAI Image 2.7 из новостей пока не появилась в каталоге APIYI — в статье она не рассматривается как доступная для вызова.
Главное: после этой статьи вы будете знать, где сверять список моделей, как решить, какой ID модели брать, какой эндпоинт нужен для каждого типа моделей и как не пытаться прикинуть весь счёт по цене одной модели. Модели и цены ниже приводятся по списку моделей и API цен APIYI apiyi.com на 2026-11-20.

Ключевые моменты подключения новых моделей в ноябре
Когда новые модели выходят одна за другой, чаще всего ошибки возникают в трёх местах: модель из новости путают с уже доступной, используют не тот эндпоинт и оценивают все затраты по одной цене. В таблице ниже эти три момента собраны вместе с правильными действиями.
| Момент | Описание | Что даёт |
|---|---|---|
| Сначала сверьтесь со списком моделей | Ориентируйтесь на общую таблицу платформы и API цен; отдельно фиксируйте модели из новостей и модели, которые реально можно вызывать | Не нужно вызывать модель по имени из презентации и получать ошибку |
| Смена модели = смена ID модели + проверка эндпоинта | В рамках одного base_url меняете параметр model, а затем проверяете, идёт ли запрос через chat, messages, responses или gemini |
Не нужно писать отдельный SDK под каждого провайдера |
| Счета смотрите отдельно по каналам | Для каждой модели и каждого эндпоинта отдельно фиксируйте входные, выходные токены и токены чтения кэша | Модели с ценой, отличающейся в разы, не усредняются вместе — затраты можно отследить |
| У вводной цены есть срок действия | У некоторых новых моделей действует ограниченная по времени вводная цена; после её окончания официальная стандартная цена изменится | Заранее оцените бюджет на следующий месяц, чтобы рост цен не сломал планы |
Подключение новой модели: модель из новости ≠ модель на витрине
Первый шаг подключения — это проверить витрину, а не писать код. Общий список моделей APIYI находится по адресу docs.apiyi.com/models.md; версия, на которую ссылается эта статья, обновлена 2026-11-19 10:59 (UTC+8). Есть ещё машиночитаемый интерфейс цен https://api.apiyi.com/api/pricing с идентификатором версии shell-api-modelmak-v1. Эти два источника могут обновляться несинхронно: например, gemini-4-neon в этой версии общего списка ещё не появилась, зато в интерфейсе цен уже есть все поля с ценами. Поэтому, решая, «можно ли вызвать модель», лучше сверяться с обоими — с общим списком и с интерфейсом цен: если запись есть хотя бы в одном из них, достаточно подтвердить одним небольшим запросом.
Обратная ситуация тоже бывает. MAI Image 2.7 — это модель генерации изображений из свежих новостей, но в текущем общем списке и интерфейсе цен APIYI есть только MAI-Image-2.6 и MAI-Image-2.6-Flash, а 2.7 нет. То есть MAI Image 2.7 пока не добавлена на витрину, мы добавим эту модель в ближайшее время, а модель и цена на тот момент будут определяться списком моделей платформы. Кроме того, Kling, Muse и gemini-4-flash-lite сейчас не находятся ни в общем списке, ни в интерфейсе цен — не стоит учитывать их при планировании.

Сопоставление новых моделей ноября и статуса в каталоге
В таблице ниже приведено соответствие между моделями, упомянутыми в ноябрьских новостях, и их статусом в каталоге на 2026-11-20. В таблицу включены только сведения, которые можно подтвердить по материалам; там, где подтверждения нет, мы не строим предположений.
| Модель | Информация из новостей | Статус в каталоге APIYI (2026-11-20) | ID модели |
|---|---|---|---|
| Gemini 4 Carbon | Выпущена 2026-11-10, ориентирована на длительные сложные задачи | Доступна в сводной таблице и API цен | gemini-4-carbon |
| Gemini 4 Hydrogen | Выпущена 2026-11-12, быстрый повседневный вариант | Доступна в сводной таблице и API цен | gemini-4-hydrogen |
| Gemini 4 Neon | Выпущена 2026-11-18, средние возможности | Есть в API цен, но в сводной таблице этой версии не указана | gemini-4-neon |
| Gemini 4 Argon | — | Доступна в сводной таблице | gemini-4-argon |
| MAI Image 2.7 | Модель для изображений из новостей | Пока не добавлена в каталог, добавим в ближайшее время | Ориентируйтесь на список на платформе |
| MAI Image 2.6 / 2.6 Flash | — | Доступна, оплата за вызов | MAI-Image-2.6 / MAI-Image-2.6-Flash |
Позиционирование трех вариантов Gemini 4 можно кратко описать так: Carbon делает упор на многошаговые и сложные задачи, Hydrogen стремится к скорости и подходит для частых повседневных вызовов, а Neon находится между ними. При выборе сначала смотрите на сложность задачи и выбирайте вариант, а уже потом на цену — так надежнее, чем сразу брать самое дешевое.
Быстрый старт с новыми моделями ноября: один вход — смена модели
Минимальный пример: меняем два параметра — и модель другая
APIYI предоставляет интерфейс, совместимый с OpenAI. При подключении новой модели почти всё сводится к двум правкам: base_url и model. На примере официального Python SDK от OpenAI минимальные шаги такие:
- Установите SDK:
pip install openai - Создайте клиент:
client = openai.OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1") - Отправьте запрос в чат:
client.chat.completions.create(model="gemini-4-hydrogen", messages=[{"role": "user", "content": "Hello!"}]) - Прочитайте результат:
response.choices[0].message.content
Чтобы перейти с Hydrogen на Carbon, достаточно заменить model="gemini-4-hydrogen" на model="gemini-4-carbon" — клиент, аутентификация и структура сообщений остаются без изменений. В этом и смысл «одного входа для смены модели»: обычно смена модели — это смена ID модели и проверка эндпоинта, а не отдельный SDK для каждого провайдера.
Посмотреть полный подход к подключению (включая переключение эндпоинтов и учёт по каналам)
В полноценном проекте советую хранить сопоставление «ID модели → эндпоинт» в конфигурации, а не разбрасывать по коду:
1. Определите конфигурацию `MODEL_ROUTES`, где каждая запись содержит три поля: `model`, `endpoint` и `price_key`. Например, `gemini-4-neon` соответствует `chat`, `claude-fable-5-2` — `messages`, а `gpt-6.2-astra` — `responses`.
2. Оберните вызов в функцию `call_model(model, prompt)`: в зависимости от `endpoint` вызывайте `client.chat.completions.create`, `client.responses.create` или отправляйте запрос через Anthropic SDK в формате Messages (`base_url` тот же).
3. После каждого ответа читайте из поля `usage` количество входных, выходных и кэшированных токенов и записывайте в локальный учёт с ключом канала `model+endpoint`.
4. Раз в день обращайтесь к эндпоинту с ценами и по `model_ratio`, `completion_ratio` и `cache_ratio` пересчитывайте цену за токен, затем умножайте на количество токенов в учёте — так получается расчётная стоимость по каждому каналу.
5. При ошибке вызова записывайте `model` и текст ошибки. Если сообщение говорит, что модели не существует, сначала сверьтесь со списком моделей и не повторяйте запрос вслепую.
Так после выхода новой модели достаточно добавить одну строку в `MODEL_ROUTES`, и бизнес-код менять не придётся.
🚀 Совет для быстрого старта: сначала зарегистрируйтесь на APIYI apiyi.com и получите бесплатный тестовый лимит для новых пользователей. Прогоните всю цепочку на повседневной модели вроде Hydrogen, затем переключитесь на Neon и Carbon, чтобы сравнить результаты. На весь процесс нужен только один API-ключ.
Сопоставление эндпоинтов новых моделей: не стоит запихивать все модели в chat
«Одна точка входа» — это не «один эндпоинт». Уже доступные текстовые модели поддерживают разные эндпоинты, и при смене модели это обязательно нужно проверять:
| Серия моделей | Пример ID модели | Доступные эндпоинты | Примечание |
|---|---|---|---|
| Серия Gemini 4 | gemini-4-carbon / gemini-4-neon / gemini-4-hydrogen |
chat или gemini | chat — это совместимый с OpenAI /v1/chat/completions; gemini — нативный формат Gemini, точный путь см. в документации платформы |
| Claude Fable 5.2 | claude-fable-5-2 / claude-fable-5-2-thinking |
chat или messages | messages — формат Anthropic, /v1/messages |
| GPT-6.2 Astra | gpt-6.2-astra |
рекомендуется responses | Рекомендуется использовать /v1/responses |
| MAI Image 2.6 | MAI-Image-2.6 / MAI-Image-2.6-Flash |
генерация изображений | Тарификация по вызовам, способ вызова см. в документации платформы |
На практике, если у команды уже много кода на формате chat, Gemini и Claude можно сначала оставить на эндпоинте chat — так миграция будет минимальной. Когда понадобятся нативные возможности производителя, переключитесь на эндпоинты gemini или messages. А GPT-6.2 Astra лучше сразу подключать через эндпоинт responses — не стоит по привычке натягивать его на chat.
Счёт за новые модели в ноябре: разбираем по каналам отдельно
Сначала научимся читать интерфейс цен
В APIYI цены в интерфейсе задаются через множители. Правила пересчёта такие:
- Цена входных токенов =
model_ratio × 2(единица — доллары за миллион токенов; приmodel_ratio= 1 это$2 / 1M) - Цена выходных токенов = цена входных токенов ×
completion_ratio - Цена чтения из кэша = цена входных токенов ×
cache_ratio
Возьмём gemini-4-neon: интерфейс цен выдаёт model_ratio 1.5, completion_ratio 5, cache_ratio 0.05. После пересчёта входные токены стоят $3 / 1M, выходные — $15 / 1M, чтение из кэша — $0.15 / 1M, что совпадает с ценой Google. Когда освоите этот способ пересчёта, сможете сами посчитать цену по https://api.apiyi.com/api/pricing сразу после выхода новой модели — не придётся ждать обновления статьи.
Сравнение цен по каналам (проверено 2026-11-20)

📊 Об источнике данных: цены на схеме выше и в таблице ниже взяты из общего списка моделей и интерфейса ценообразования APIYI apiyi.com; дата проверки — 2026-11-20. Дальнейшие изменения смотрите в актуальном списке на платформе.
| Канал (ID модели) | Ввод | Чтение кэша | Вывод | Примечание |
|---|---|---|---|---|
gemini-4-hydrogen |
$1.5 / 1M |
$0.075 / 1M |
$7.5 / 1M |
Быстрый повседневный режим |
gemini-4-carbon |
$2 / 1M |
$0.1 / 1M |
$10 / 1M |
Соответствует вводной цене Google до 2026-11-30 |
gemini-4-argon |
$2 / 1M |
$0.1 / 1M |
$10 / 1M |
Из общего списка |
gemini-4-neon |
$3 / 1M |
$0.15 / 1M |
$15 / 1M |
Из интерфейса ценообразования |
claude-fable-5-2 / -thinking |
$8 / 1M |
$0.2 / 1M |
$40 / 1M |
Цена одинакова для обоих ID |
gpt-6.2-astra (первая ступень) |
$8 / 1M |
$0.4 / 1M |
$40 / 1M |
Свыше 272000 token — см. ниже |
MAI-Image-2.6 |
за вызов $0.12 |
— | — | Изображение |
MAI-Image-2.6-Flash |
за вызов $0.06 |
— | — | Изображение |
В таблице есть два момента, которые стоит пояснить отдельно.
Первый — ступенчатая тарификация длинного контекста у GPT-6.2 Astra. В общем списке указано, что при превышении 272000 token ввод становится $16 / 1M; интерфейс ценообразования уточняет: при превышении 272000 token вывод считается по $60 / 1M, а чтение кэша — по $0.8 / 1M. Если в ваших задачах бывает очень длинный контекст, обязательно считайте по ступеням отдельно и не применяйте цену первой ступени ко всем запросам.
Второй — вводная цена Gemini 4 Carbon. Текущая цена соответствует вводной цене Google до 2026-11-30; с 1 декабря стандартная цена Google — $4 / 1M за ввод и $20 / 1M за вывод. Дальнейшие цены на платформе — по списку моделей APIYI; при планировании бюджета на декабрь лучше заранее заложить эту разницу.
Почему нельзя судить обо всём по цене одного провайдера
Из таблицы выше видно: при выводе миллиона токенов Hydrogen стоит $7.5, а первая ступень тарификации у Claude Fable 5.2 и GPT-6.2 Astra — $40. Разница больше чем в пять раз. Если команда одновременно использует три-четыре модели, ориентироваться только на «среднюю цену» или на цену одного провайдера — значит легко серьёзно занизить или завысить затраты. Надёжнее действовать так: в качестве ключа канала использовать «ID модели + эндпоинт», отдельно учитывать по каждому каналу входные и выходные токены, а также токены чтения кэша, умножать каждую категорию на соответствующую цену и в конце суммировать.
Ещё стоит учесть: единая точка входа снижает затраты на интеграцию, но это не значит, что каждая модель обязательно дешевле. В таблице выше цены нескольких моделей Gemini 4 совпадают с официальными ценами Google. Выгодно ли это, нужно сравнивать по каждому каналу с вашим реальным потреблением, а не делать общие выводы.
💰 Совет по затратам: когда сравниваете варианты для выбора, можно на платформе APIYI (apiyi.com) вызвать Hydrogen, Neon и Carbon на одной и той же выборке тестовых примеров, затем записать расход токенов по каждому каналу, вычислить реальную стоимость одного вызова для каждого канала и уже потом выбрать основную модель.
Часто задаваемые вопросы (FAQ)
Q1: Что значит «один вход — разные модели»?
Это когда все модели используют один и тот же `base_url` и один и тот же API Key. При переключении модели вы меняете ID модели в параметре `model` и проверяете, что выбранная модель поддерживает нужный эндпоинт. Не нужно отдельно регистрироваться у каждого провайдера и отдельно подключать SDK.
Q2: Можно ли сразу вызвать модель, которую только что анонсировали в новостях?
Не всегда. Анонс ещё не означает, что модель уже доступна в каталоге. Например, по состоянию на 2026-11-20 MAI Image 2.7 упоминалась только в новостях, а в каталоге APIYI были доступны лишь `MAI-Image-2.6` и `MAI-Image-2.6-Flash`; 2.7 ещё не появилась в каталоге, но её добавят в ближайшее время. Перед вызовом проверьте сводную таблицу и эндпоинт цен и убедитесь, что ID модели существует, а уже потом подключайтесь.
Q3: Как выбрать между Carbon, Hydrogen и Neon у Gemini 4?
Выбирайте уровень под сложность задачи: для длинных цепочек и сложных задач — Carbon; для частых повседневных вызовов, где важна скорость, — Hydrogen; для промежуточных случаев — Neon. Все три версии вышли 10, 12 и 18 ноября соответственно, и цены у них разные. Рекомендую сначала сравнить их на одном и том же наборе тестовых запросов, а потом выбирать основную модель.
Q4: В сводной таблице нет gemini-4-neon — значит, её ещё нельзя использовать?
Не стоит ориентироваться только на сводную таблицу. В версии сводной таблицы от 2026-11-19 `gemini-4-neon` не было, но эндпоинт цен уже выдаёт полные коэффициенты: после пересчёта получается вход `$3 / 1M`, выход `$15 / 1M`, чтение кэша `$0.15 / 1M`. Между этими источниками есть временной разрыв, поэтому ориентируйтесь на эндпоинт цен и результаты небольшого реального теста.
Q5: Как быстро вызывать эти новые модели ноября через API?
Рекомендую такой порядок действий:
1. Зарегистрируйте аккаунт на APIYI apiyi.com, получите API Key и бесплатный тестовый лимит для новых пользователей.
2. Проверьте сводную таблицу моделей и эндпоинт цен, чтобы подтвердить ID нужной модели.
3. Укажите в `base_url` OpenAI-совместимый адрес платформы и выберите chat, messages, responses или gemini по таблице соответствия эндпоинтов выше.
4. Сначала отправьте короткий запрос, убедитесь, что всё работает, и только потом подключайте модель к рабочему процессу.
Q6: У одного и того же Claude Fable 5.2 цены через chat и messages различаются?
В справочных материалах у `claude-fable-5-2` и `claude-fable-5-2-thinking` указана одинаковая цена: вход `$8 / 1M`, чтение кэша `$0.2 / 1M`, выход `$40 / 1M`. Разделения цен по эндпоинтам в материалах нет. Тем не менее при учёте расходов всё равно рекомендую включать эндпоинт в ключ канала — так проще разбираться с проблемами и проверять данные позже.
Q7: Единая точка входа всегда дешевле прямого подключения к официальному API?
Такой вывод сделать нельзя. Главная ценность единой точки входа — меньше интеграций и единые входы для аутентификации и биллинга. Цену нужно смотреть по каждому каналу отдельно: например, цена `gemini-4-neon` совпадает с ценой Google. Экономичнее ли это в вашем случае, зависит от набора моделей и объёма использования — считайте по каналам самостоятельно.
Q8: Какие известные ограничения стоит учесть заранее?
Главных моментов три. Во-первых, часть новых моделей ещё не появилась в каталоге — например, MAI Image 2.7, Kling, Muse и `gemini-4-flash-lite` сейчас не найти. Во-вторых, у вводных цен есть срок действия: вводная цена Google для Gemini 4 Carbon действует до 30 ноября. В-третьих, GPT-6.2 Astra после 272000 токенов тарифицируется по ступенчатой схеме. Если столкнулись с такими ситуациями, сначала подстройте план под список платформы, а потом возвращайтесь править код.
Ключевые тезисы подключения новых моделей в ноябре (Key Takeaways)
- Сначала проверьте каталог, потом пишите код: ориентируйтесь на сводную таблицу моделей и интерфейс цен; новостные модели и модели, доступные для вызова, фиксируйте отдельно
- Смена модели — только два места: в одном и том же base_url меняете ID модели, затем проверяете тип эндпоинта
- Эндпоинт должен соответствовать модели: Gemini идёт через chat или gemini, Claude — через chat или messages, для GPT-6.2 Astra рекомендуется responses
- Умеете читать множитель — умеете считать цену:
model_ratio × 2— это цена за вход, дальше умножаете на множители выхода и кеша - Счёт разбивайте по каналам: ведите учёт отдельно по ключу «ID модели + эндпоинт», не применяйте одну цену ко всему
- Следите за сроками и ступенями: вводная цена Carbon и ступень 272000 токенов у Astra — всё это влияет на бюджет
- Как начать: в APIYI получите бесплатный лимит с одним ключом, сначала прогоните повседневный тариф, затем сравните варианты между собой
Итог: в ноябре — наплыв новых моделей, одна точка входа для смены модели, а биллинг — по каналам отдельно
Когда в ноябре новые модели выходят одна за другой, главное при подключении — не гоняться за каждой новостью, а выстроить один раз и дальше повторять фиксированный процесс:
- Сверяйтесь со списком моделей: проверяйте в двух местах — в общем каталоге и в интерфейсе цен. Упомянутая в новостях MAI Image 2.7 пока не появилась в каталоге, так что не включайте её в план запуска.
- Меняйте ID модели и проверяйте эндпоинт: один base_url — и несколько моделей разных провайдеров; chat, messages, responses или gemini выбирайте по таблице соответствия эндпоинтов.
- Смотрите биллинг по каналам: токены и расходы считайте отдельно по каждой модели и каждому эндпоинту, и при этом следите за датой окончания промо-цены и за ступенчатой тарификацией для длинного контекста.
Когда процесс уже отлажен, при выходе следующей новой модели достаточно добавить одну строку с ID модели в конфиг и один раз заглянуть в интерфейс цен — и подключение вместе с оценкой стоимости готовы. Рекомендуем на APIYI apiyi.com сначала прогнать один канал на бесплатном лимите для новых пользователей, а потом постепенно добавлять в сравнение Gemini 4, Claude Fable 5.2 и GPT-6.2 Astra.
📚 Справочные материалы
-
Официальный блог Google — анонс Gemini 4 Neon: описание моделей серии Gemini 4
- Ссылка:
blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon - Пояснение: о позиционировании Carbon, Hydrogen и Neon и о датах их выхода
- Ссылка:
-
Общий каталог моделей и интерфейс цен APIYI: источник для сверки моделей и цен
- Ссылка: см. в тексте раздел «Модель из новости ≠ модель на витрине»
- Пояснение: версии общего каталога и интерфейса цен могут расходиться, поэтому лучше сверять в обоих местах
Автор: техническая команда APIYI
Обсуждение: пишите нам на главной странице сайта APIYI; больше документации по подключению — в центре документации docs.apiyi.com
