Gemini 4 Carbon официально открыл API: точка входа, ID модели и стартовое ценовое окно — краткий обзор (подключение за 5 шагов)

От автора: в статье собраны официальная точка входа в API Gemini 4 Carbon, идентификатор модели, способы вызова и сроки действия стартовой цены. Это поможет разработчикам оценить подключение до окончания акции 30 ноября.

7 терминов, которые стоит знать перед подключением

10 ноября 2026 года Google опубликовала пост «Gemini 4 Carbon is now available» и объявила, что Gemini 4 Carbon официально открыт для платных разработчиков Gemini API. До этого, с момента первого анонса 28 октября, модель была доступна лишь отдельным специалистам по кибербезопасности, прошедшим отбор.

Это не очередной пересказ новости о релизе модели. Здесь только то, что действительно важно разработчикам: где находится точка входа для вызова Gemini 4 Carbon, какой ID модели указывать, как писать код и когда заканчивается окно стартовой цены.

Главная польза: прочитав статью, вы сможете подключить Gemini 4 Carbon по API за 5 шагов и чётко разделять три вещи: доступ через платный API, доступ по потребительской подписке и реальную стоимость ваших задач.

Gemini 4 Carbon теперь в открытом доступе: разработчики могут вызывать модель напрямую

Gemini 4 Carbon разработана в Google DeepMind на базе Gemini 4 Argon. Это флагманская модель для рассуждений, ориентированная на сложные задачи: продвинутую программную инженерию, долгие агентные воркфлоу, научные исследования и защиту от киберугроз. Её фишка в том, что она способна тратить больше «думающих» токенов и на сложных задачах перебирает гипотезы, планирует, выполняет, проверяет результат и исправляет ошибки.

Открытие доступа 10 ноября охватило сразу несколько каналов. Разработчики могут пользоваться моделью через платный тариф Gemini API, Google AI Studio и Android Studio. Компании получают доступ через Gemini for business. Обычным пользователям нужна подписка Google AI Ultra, чтобы работать с моделью в приложении Gemini, Google Antigravity и в режиме Google Search AI Mode. Для рядового разработчика главное изменение такое: достаточно подключить платный API, и Carbon можно вызывать напрямую.

Gemini 4 Carbon: ключевые моменты подключения

Как разделить задачи между Carbon и Argon

Важно понимать: Carbon не заменяет Argon целиком. Google прямо говорит, что Gemini 4 Argon по-прежнему лучший выбор для большинства задач в программной инженерии и работе со знаниями. Carbon лучше подходит там, где нужны более глубокие рассуждения, более долгое выполнение и более сложная проверка результата.

Поэтому при планировании интеграции разумно отдать Carbon «трудные» задачи: проектирование архитектуры, аудит сложного кода, поиск первопричин сбоев на стыке нескольких подсистем. А обычную генерацию кода и пакетную обработку оставить более быстрым и лёгким моделям. Именно такое разделение Google рекомендует для функции предпросмотра мультиагентного режима /swarm в Antigravity.

Где точка входа для вызова API Gemini 4 Carbon

Официальный путь подключения Gemini 4 Carbon сосредоточен в Google AI Studio. Весь процесс разбивается на пять шагов, и каждый соответствует конкретной странице или параметру конфигурации:

1. Зайти в Google AI Studio: войдите в AI Studio под своим аккаунтом Google.
2. Создать API-ключ: откройте страницу API Keys и создайте новый ключ для вызовов Carbon.
3. Включить платный уровень: настройте Google Cloud Billing и привяжите способ оплаты. У Carbon нет бесплатного уровня API — этот шаг пропустить нельзя.
4. Выбрать Gemini 4 Carbon: в Playground просто выберите gemini-4-carbon для теста либо укажите этот ID модели в SDK.
5. Начать вызовы: отправляйте запросы через Python SDK, JavaScript SDK или REST API.

Права API и права подписки у Gemini 4 Carbon

В обсуждениях на Hacker News и Reddit многие разработчики путают два разных вопроса: «можно ли пользоваться Carbon в приложении Gemini» и «можно ли вызывать Carbon через API». На самом деле это два совершенно независимых пути, и таблица ниже разбирает условия для каждого канала по отдельности.

Если коротко: разработчику для вызова Carbon покупать Ultra не нужно, а вот пользователю, который хочет работать с Carbon в приложении, Ultra понадобится. Ещё один момент: Google Cloud Developer Credits, которые идут в комплекте с подписками Google AI (например, $10 в месяц у AI Pro), — это льгота программы Cloud для разработчиков, и её нельзя считать бесплатной квотой токенов именно для Carbon. Конкретные условия зачёта средств зависят от сервиса, региона и параметров аккаунта.

Как вызвать Gemini 4 Carbon через API: быстрый старт

Официальная рекомендация: минимальный пример с Interactions API (Python)

Google сейчас советует в новых проектах использовать Interactions API. Он объединяет вызов модели, оркестрацию инструментов, многошаговое взаимодействие и рабочие процессы агентов. Традиционный GenerateContent API по-прежнему поддерживается. Ниже приведён Python-код, оформленный по официальному примеру Interactions. В исходных дополнительных материалах он был вставлен в одну строку, поэтому выполнить его напрямую было нельзя.

from google import genai

client = genai.Client()
interaction = client.interactions.create(
    model="gemini-4-carbon",
    input="Write a Three.js script that renders a 3D scene."
)
print(interaction.output_text)

Перед запуском выполните pip install google-genai и задайте API-ключ, созданный в AI Studio, в переменной окружения GEMINI_API_KEY: genai.Client() подхватит его автоматически. Обратите внимание: в этом примере мы только исправили оформление, а сам вызов модели на практике не проверяли. Ориентируйтесь на актуальный вариант из официальной документации.

Пример вызова через REST API

Если подключать SDK в проект неудобно, можно обращаться напрямую к официальному REST-эндпоинту https://generativelanguage.googleapis.com/v1beta/interactions, передавая API-ключ в заголовке x-goog-api-key:

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "model": "gemini-4-carbon",
    "input": "Hello"
  }'

В JavaScript-проектах используется пакет @google/genai, вызов делается так же — client.interactions.create(); смысл ID модели и полей ввода тот же, что и в Python.

Настройка уровня размышлений thinking_level в Gemini 4 Carbon

Carbon предоставляет параметр thinking_level со значениями low, medium и high; публичная модель gemini-4-carbon по умолчанию работает на MEDIUM. Где именно этот параметр находится в теле запроса, уточняйте в официальном документе «What’s new in Gemini 4 Carbon». Типичные задачи для трёх уровней:

• low — лёгкие задачи: классификация, суммаризация, извлечение метаданных;
• medium — обычный код, вызов модели с инструментами, вопросы-ответы по документам, понимание видео;
• high — многофайловая разработка ПО, проектирование архитектуры, формальные доказательства, поиск уязвимостей.

При переносе старого кода есть важный нюанс: thinking_budget в Carbon не поддерживается — если его передать, вернётся HTTP 400; уровень MINIMAL тоже недоступен.

Вызов через OpenAI-совместимый интерфейс (ориентируйтесь на актуальный список моделей платформы)

Если ваш проект уже построен на OpenAI SDK и вы хотите управлять сразу несколькими моделями через один ключ, можно воспользоваться OpenAI-совместимым агрегирующим интерфейсом. Пример ниже показывает только общий принцип: доступна ли модель gemini-4-carbon и как она называется на самом деле, смотрите в списке моделей на платформе:

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # OpenAI-совместимый интерфейс APIYI
)

response = client.chat.completions.create(
    model="gemini-4-carbon",  # Пример названия, актуальное имя смотрите в списке моделей платформы
    messages=[{"role": "user", "content": "用三句话解释什么是长周期 Agent。"}]
)
print(response.choices[0].message.content)

import openai
from typing import Optional, List

def call_model(
    prompt: str,
    models: List[str],
    system_prompt: Optional[str] = None,
    max_tokens: int = 4096
) -> str:
    """
    Поочерёдно пробует несколько моделей и возвращает результат первой успешной.
    Удобно для плавного отката на другую модель в первое время после выхода новой.
    """
    client = openai.OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://api.apiyi.com/v1"
    )

    messages = []
    if system_prompt:
        messages.append({"role": "system", "content": system_prompt})
    messages.append({"role": "user", "content": prompt})

    last_error = None
    for model in models:
        try:
            response = client.chat.completions.create(
                model=model,
                messages=messages,
                max_tokens=max_tokens
            )
            return f"[{model}] " + response.choices[0].message.content
        except Exception as e:
            last_error = e
            continue
    return f"Error: {last_error}"

# Пример использования: названия моделей смотрите в списке моделей платформы
result = call_model(
    prompt="审查这段架构设计中的单点故障风险。",
    models=["gemini-4-carbon", "gemini-4-argon"],
    system_prompt="你是一名资深后端架构师,回答要具体、可执行。"
)
print(result)

🚀 Совет для быстрого старта: если вам нужно сравнить Carbon, Argon и модели других разработчиков, можно переключаться между ними через APIYI (apiyi.com) с одним ключом и единым OpenAI-совместимым интерфейсом. Для новых пользователей есть бесплатный тестовый лимит. Точную дату выхода Gemini 4 Carbon и название модели смотрите в информации, опубликованной в консоли платформы.

Какие возможности поддерживает Gemini 4 Carbon API

Согласно документации по модели Carbon в Google AI Studio и официальной карточке модели, Carbon — это рассуждающая модель с «мультимодальным входом и текстовым выходом», а также с полноценным набором инструментов для разработки агентов. В таблице ниже собраны характеристики, которые чаще всего нужны при подключении.

Ограничения совместимости параметров Gemini 4 Carbon

Carbon обрабатывает часть привычных параметров сэмплирования иначе, чем старые модели, поэтому при миграции кода легко наступить на грабли. Согласно руководству для разработчиков Google Cloud: temperature, top_p и top_k игнорируются; frequency_penalty и presence_penalty не поддерживаются; если candidate_count больше 1, возвращается ошибка.

Что касается кэширования: Carbon не поддерживает явный Context Caching, зато умеет автоматически кэшировать неявно. Кэш может сработать, если общий префикс промпта у запросов достигает 4096 токенов и более. На практике стоит ставить в самое начало запроса системный промпт, объявления инструментов и фиксированные справочные документы и не менять их, а изменяющийся пользовательский ввод — добавлять в конец. Так вероятность попадания в кэш будет выше.

Gemini 4 Carbon: стартовые цены и повышение с 1 декабря

У цен на Gemini 4 Carbon есть две даты, которые нужно запомнить: до 30 ноября 2026 года действуют стартовые цены, а с 1 декабря 2026 года цены на вход и выход вырастут вдвое. Все цены ниже взяты со страницы официальных тарифов API в Google AI Studio и указаны в долларах за миллион токенов, то есть по официальным тарифам Google.

Из таблицы видно, что кэшированный вход стоит на 95% дешевле обычного. Batch и Flex вдвое дешевле Standard, поэтому они подходят для офлайн-задач, где скорость ответа не критична. Priority стоит дороже и подойдёт для продакшена, где важны низкая задержка и стабильность.

Как на самом деле считается счёт за Gemini 4 Carbon

Цена за токен — это только отправная точка. На итоговую стоимость Carbon влияют ещё три фактора:

• Токены размышлений входят в стоимость вывода: рассуждения, которые модель генерирует на уровнях medium и high, тарифицируются по цене выходных токенов. Поэтому оценивать счёт только по длине финального ответа, который видит пользователь, нельзя.
• Grounding даёт дополнительные расходы: при использовании Grounding в счёт попадают также внутренние системные инструкции инструментов и объявления функций. У Google Search Grounding есть бесплатная квота — 5 000 запросов в месяц, общая с Gemini 3 и более новыми моделями. Сверх неё каждые 1 000 запросов стоят 14 долларов, а один пользовательский запрос может запустить сразу несколько поисков.
• Доля попаданий в кэш: входные токены, найденные в неявном кэше, тарифицируются по цене кэша. Хорошо структурированный промпт заметно снижает стоимость работы с длинным контекстом.

Разберём гипотетический пример. Запрос: 20 000 входных токенов, а размышления вместе с финальным ответом дают 8 000 токенов; кэш и вызовы инструментов не учитываем. По стартовой цене Standard выходит примерно 0,02 × $2 + 0,008 × $10 = $0,12. После 1 декабря при том же объёме будет около $0,24. Чем больше токенов размышлений, тем выше доля расходов на стороне вывода.

Сторонние данные это подтверждают. Artificial Analysis посчитал стоимость по стандартным ценам $4 / $20. Средняя стоимость одной задачи в Intelligence Index v5.0.1 для Carbon получилась такой: Low — около $7,19, Medium — около $6,59, High — около $7,76. Medium оказался дешевле Low, то есть связи между уровнем и стоимостью прямой пропорции нет. Эти цифры — средние по комплексным задачам бенчмарка, а не цена обычного одиночного запроса.

💰 Совет по затратам: перед запуском в продакшен прогоните небольшой набор реальных задач на каждом из уровней — low, medium и high — и запишите соотношение токенов размышлений и выходных токенов. Только после этого выбирайте уровень по умолчанию. Если в проекте используется сразу несколько моделей, сравнивать их реальный расход удобно через единую панель биллинга APIYI на apiyi.com.

На что обратить внимание перед подключением Gemini 4 Carbon

Прежде чем тащить модель в продакшен-код, стоит по очереди проверить несколько ограничений:

1. Бесплатного API-уровня нет: в AI Studio Playground Carbon можно попробовать, но сама модель не предоставляет бесплатный уровень API — для вызовов нужен платный аккаунт.
2. Подписка Ultra не нужна для API: покупать Google AI Ultra разработчикам не требуется. И наоборот, подписка Ultra не заменяет оплату API-счетов.
3. Задержка ответа довольно высокая: в карточке модели предупреждают, что на высоких уровнях рассуждения возможны медленные ответы и таймауты. По замерам Artificial Analysis, время до первого токена ответа у Carbon High составляет около 67,54 секунды, поэтому напрямую заменить модель для чата в реальном времени она не подойдёт.
4. Галлюцинации всё ещё возможны: Google признаёт, что Carbon по-прежнему может галлюцинировать, а защиту от Prompt Injection тоже нужно улучшать. В критичных для бизнеса сценариях стоит оставить этап проверки результата.
5. У возможностей в области кибербезопасности есть порог входа: официально заявленные результаты по поиску уязвимостей отражают специализированные возможности при работе через Fairwind Program. Их нельзя приравнивать к функциям, которые безусловно доступны через обычный API.
6. Цены актуальны на определённую дату: информация о ценах и правах доступа в этой статье основана на данных от 11 ноября 2026 года, поэтому позже сверяйтесь с официальными страницами.

Часто задаваемые вопросы (FAQ)

Gemini 4 Carbon: главное (Key Takeaways)

• Официальный запуск: с 10 ноября 2026 года платные разработчики Gemini API могут напрямую вызывать Carbon.
• ID модели: стабильный ID — gemini-4-carbon, для подключения официально рекомендуется Interactions API.
• Точка входа: создайте ключ в Google AI Studio, привяжите Cloud Billing — и можно работать.
• Ценовое окно: до 30 ноября — $2 / $10, с 1 декабря — $4 / $20 (за миллион токенов).
• Права доступа: для вызова через API подписка Ultra не нужна, она требуется только для использования Carbon внутри приложения.
• Ключевой момент по стоимости: токены рассуждений входят в выходные, а итоговый счёт зависит от уровня рассуждения, вызовов инструментов и кэша.
• Сравнение моделей: можно тестировать через единый интерфейс APIYI (apiyi.com); о доступности Carbon на платформе смотрите официальные объявления.

Итоги

Главное об открытом API Gemini 4 Carbon:

1. Понятный вход: Google AI Studio → API Keys → Cloud Billing → выбрать gemini-4-carbon → сделать вызов. Подключение занимает 5 шагов.
2. Приоритет интерфейсов: в новых проектах лучше сразу использовать Interactions API. GenerateContent по-прежнему поддерживается, но при миграции учтите, что параметры вроде thinking_budget больше недоступны.
3. Ценовые рубежи: до 30 ноября действует стартовое окно с особой ценой, а с 1 декабря цены вырастают вдвое на всех позициях. Планируя бюджет, включайте токены размышлений в стоимость вывода.

Если хотите уложить оценку модели в стартовое окно, сначала прогоните на уровне medium набор реальных задач и зафиксируйте структуру токенов. Только после этого выбирайте конфигурацию для продакшена. А если нужно сравнить несколько моделей разных вендоров, удобно подключить их через APIYI (apiyi.com) и тестировать в одном месте. Доступна ли Gemini 4 Carbon, смотрите в списке моделей на платформе.

📚 Источники

1. Официальный анонс открытия Gemini 4 Carbon: блог Google
2. Ссылка: blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-4-carbon-now-available

3. Описание: дата открытия, доступ по разным каналам и изменения цен

4. Документация по API-модели Gemini 4 Carbon: Google AI Studio

5. Ссылка: aistudio.google.com/docs/models/gemini-4-carbon

6. Описание: ID модели, входные и выходные модальности, контекст и возможности инструментов

7. What’s new in Gemini 4 Carbon: руководство по подключению в Google AI Studio

8. Ссылка: aistudio.google.com/docs/whats-new-gemini-4-carbon

9. Описание: примеры Interactions API и параметр thinking_level

10. Цены Gemini API: Google AI for Developers

11. Ссылка: ai.google.dev/gemini-api/docs/pricing

12. Описание: цены Standard, Batch, Flex, Priority и цены на кеширование

13. Руководство разработчика по Gemini 4 Carbon: Google Cloud

14. Ссылка: docs.cloud.google.cn/gemini-enterprise-agent-platform/models/guides/gemini-4-carbon

15. Описание: ограничения параметров, Long Decode и правила неявного кеширования

16. Карточка модели Gemini 4 Carbon: Google DeepMind

17. Ссылка: deepmind.google/models/model-cards/gemini-4-carbon

18. Описание: технические параметры, дата отсечки знаний и известные ограничения

19. Независимый анализ Gemini 4 Carbon: Artificial Analysis

20. Ссылка: artificialanalysis.ai/models/gemini-4-carbon
21. Описание: стоимость задач и данные по задержкам на разных уровнях размышления

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