|

Как подключить множество новых моделей ноября? Единый вход для смены модели, счета отдельно по каналам

Как подключить множество новых моделей ноября? Единый вход для смены модели, счета отдельно по каналам

Примечание автора: в ноябре 2026 года новые модели выходят одна за другой. В этой статье — о том, как менять модель на одном входе, подключаться по эндпоинтам и вести раздельный учёт затрат по каждому каналу.

Прошло всего три недели ноября, а Google уже выпустила три модели Gemini 4: 10 ноября — Carbon, 12 ноября — Hydrogen, 18 ноября — Neon. В новостях то и дело появляются новые модели для изображений, кодинга и других направлений. Для разработчика, который хочет попробовать новую модель, сложность не в том, чтобы написать код вызова, а в том, что у каждого вендора свой SDK, своя аутентификация и своя логика биллинга. Вот более простой путь: один вход для смены модели, счета — по каналам отдельно.

Это не рекламный список «всех новинок сразу». Модели, о которых пишут в новостях, и модели, которые уже можно вызывать на платформе, здесь идут отдельно. Например, MAI Image 2.7 из новостей пока не появилась в каталоге APIYI — в статье она не рассматривается как доступная для вызова.

Главное: после этой статьи вы будете знать, где сверять список моделей, как решить, какой ID модели брать, какой эндпоинт нужен для каждого типа моделей и как не пытаться прикинуть весь счёт по цене одной модели. Модели и цены ниже приводятся по списку моделей и API цен APIYI apiyi.com на 2026-11-20.

november-new-models-one-endpoint-switch-model-billing-by-channel-ru-image-0


Ключевые моменты подключения новых моделей в ноябре

Когда новые модели выходят одна за другой, чаще всего ошибки возникают в трёх местах: модель из новости путают с уже доступной, используют не тот эндпоинт и оценивают все затраты по одной цене. В таблице ниже эти три момента собраны вместе с правильными действиями.

Момент Описание Что даёт
Сначала сверьтесь со списком моделей Ориентируйтесь на общую таблицу платформы и 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 сейчас не находятся ни в общем списке, ни в интерфейсе цен — не стоит учитывать их при планировании.

november-new-models-one-endpoint-switch-model-billing-by-channel-ru-image-1

Сопоставление новых моделей ноября и статуса в каталоге

В таблице ниже приведено соответствие между моделями, упомянутыми в ноябрьских новостях, и их статусом в каталоге на 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 минимальные шаги такие:

  1. Установите SDK: pip install openai
  2. Создайте клиент: client = openai.OpenAI(api_key="YOUR_API_KEY", base_url="https://api.apiyi.com/v1")
  3. Отправьте запрос в чат: client.chat.completions.create(model="gemini-4-hydrogen", messages=[{"role": "user", "content": "Hello!"}])
  4. Прочитайте результат: 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)

november-new-models-one-endpoint-switch-model-billing-by-channel-ru-image-2

📊 Об источнике данных: цены на схеме выше и в таблице ниже взяты из общего списка моделей и интерфейса ценообразования 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 получите бесплатный лимит с одним ключом, сначала прогоните повседневный тариф, затем сравните варианты между собой

Итог: в ноябре — наплыв новых моделей, одна точка входа для смены модели, а биллинг — по каналам отдельно

Когда в ноябре новые модели выходят одна за другой, главное при подключении — не гоняться за каждой новостью, а выстроить один раз и дальше повторять фиксированный процесс:

  1. Сверяйтесь со списком моделей: проверяйте в двух местах — в общем каталоге и в интерфейсе цен. Упомянутая в новостях MAI Image 2.7 пока не появилась в каталоге, так что не включайте её в план запуска.
  2. Меняйте ID модели и проверяйте эндпоинт: один base_url — и несколько моделей разных провайдеров; chat, messages, responses или gemini выбирайте по таблице соответствия эндпоинтов.
  3. Смотрите биллинг по каналам: токены и расходы считайте отдельно по каждой модели и каждому эндпоинту, и при этом следите за датой окончания промо-цены и за ступенчатой тарификацией для длинного контекста.

Когда процесс уже отлажен, при выходе следующей новой модели достаточно добавить одну строку с ID модели в конфиг и один раз заглянуть в интерфейс цен — и подключение вместе с оценкой стоимости готовы. Рекомендуем на APIYI apiyi.com сначала прогнать один канал на бесплатном лимите для новых пользователей, а потом постепенно добавлять в сравнение Gemini 4, Claude Fable 5.2 и GPT-6.2 Astra.


📚 Справочные материалы

  1. Официальный блог Google — анонс Gemini 4 Neon: описание моделей серии Gemini 4

    • Ссылка: blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-neon
    • Пояснение: о позиционировании Carbon, Hydrogen и Neon и о датах их выхода
  2. Общий каталог моделей и интерфейс цен APIYI: источник для сверки моделей и цен

    • Ссылка: см. в тексте раздел «Модель из новости ≠ модель на витрине»
    • Пояснение: версии общего каталога и интерфейса цен могут расходиться, поэтому лучше сверять в обоих местах

Автор: техническая команда APIYI
Обсуждение: пишите нам на главной странице сайта APIYI; больше документации по подключению — в центре документации docs.apiyi.com

Читайте также

Похожие записи