Gemini 4 Carbon

Используйте gemini-4-carbon в нативном формате Gemini. На странице модели доступны Playground и актуальные цены. Gemini 4 Carbon использует тот же формат запроса, что и Gemini 4 Argon; согласно руководству Google, для перехода между ними нужно изменить только ID модели.

ID модели

Краткий пример

curl https://api.seedrouter.ai/v1beta/models/gemini-4-carbon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Find the race condition in a retry loop that re-reads a balance before locking it."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"medium"},"maxOutputTokens":32768}}'

Модель указывается в URL. Поле contents обязательно. Ответ содержит нативные candidates, finishReason и usageMetadata; сохраняйте части содержимого целиком, включая thoughtSignature, в истории диалога. Сложные промпты могут обрабатываться несколько минут. Запрос без потоковой передачи, выполняющийся дольше примерно 100 секунд, может завершиться с HTTP 524 до получения ответа, поэтому для долгих задач используйте streamGenerateContent; в примерах также задан тайм-аут клиента 15 минут, как рекомендует Google.

Конечные точки

Спецификация OpenAPI содержит все вложенные схемы запросов и ответов. Для пропущенных необязательных полей действуют значения API по умолчанию. SeedRouter передаёт тело запроса без фильтрации неизвестных полей, удаления неподдерживаемых полей или проверки значений параметров модели. Принимать ли запрос, решает Gemini API.

Параметры запроса

URL фиксирует модель gemini-4-carbon. Контракт запроса содержит 11 полей верхнего уровня. Поля необязательны, если не указано иное; отсутствие поля отличается от JSON null. Произвольный JSON с допустимым null сохраняется там, где это разрешает официальная схема.

Явное кэширование контекста (cachedContent и ресурсы cachedContents) не поддерживается в Gemini 4 Carbon. Неявное кэширование включено по умолчанию для промптов от 4 096 токенов.

Параметры генерации

Документ OpenAPI перечисляет вложенные типы, enum, обязательные свойства и документированные границы для каждого сообщения. Схемы описывают официальные параметры и не служат списком разрешённых полей запроса SeedRouter. Переданные вызывающей стороной поля и значения сохраняются. Соответствие поля схеме не доказывает его поддержку каждым аккаунтом. minimal не входит в список уровней рассуждений. По данным Google, temperature, topP и topK игнорируются этой моделью; candidateCount не является официальной настройкой. При передаче в нативном JSON они всё равно проходят без изменений для обработки Gemini API. Завершайте диалог содержимым пользователя; пользовательские ходы только с ответом функции остаются допустимыми.

Поэтапная генерация длинного ответа

Один ответ Gemini 4 Carbon возвращает до 65 536 токенов при потоковой передаче и до 32 768 без неё. Для более длинного ответа задайте maxOutputTokens выше 65 536 и самостоятельно продолжайте ответ:

1. Отправьте запрос. Если ответ завершается с finishReason: "CONTINUATION", прочитайте candidates[0].continuationToken.
2. Повторно отправьте тот же запрос, указав полученное значение в поле верхнего уровня continuationToken. Не добавляйте частичный выход в contents; токен содержит состояние модели, включая её рассуждения.
3. Повторяйте, пока finishReason не станет STOP или MAX_TOKENS.

{
  "contents": [{"role": "user", "parts": [{"text": "Write a complete, rigorous proof of the prime number theorem."}]}],
  "generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
  "continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}

Этап, целиком потраченный на рассуждения, может вернуть пустой текст с CONTINUATION; это нормальный ход генерации. На каждом этапе промпт и всё сгенерированное к этому моменту отправляются модели заново, поэтому на каждом следующем этапе входные токены учитываются повторно. SeedRouter тарифицирует каждый этап как отдельный запрос. Серверный режим background API Interactions не входит в этот эндпоинт.

Структурированный вывод

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 32768,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

Старые поля responseSchema и responseJsonSchema нельзя использовать вместе. Оба требуют responseMimeType: "application/json". Новая схема responseFormat.text также должна указывать JSON. В этом сообщении используйте написание enum из REST (APPLICATION_JSON и TEXT_PLAIN). Запросы передаются без изменений; MIME-типы медиа и произвольный JSON функций не переписываются.

Функции и встроенные инструменты

Используйте tools[].functionDeclarations с именем и одним из полей parameters или parametersJsonSchema, но не обоими. Выбор функций задаётся в toolConfig.functionCallingConfig; allowedFunctionNames требует ANY или VALIDATED и объявленных имён.

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

Google указывает для этой модели Search, Maps, выполнение кода, контекст URL, File Search и Computer Use. Ресурсы File Search требуют доступа с учётными данными, обслуживающими запрос. Нативные настройки MCP присутствуют в общей схеме, но их доступность для этой модели не подтверждена. Google Maps требует только текстового ввода; перед сочетанием Maps с медиа проверьте ограничения официального API. При grounding Google учитывает внутренние инструкции инструментов и объявления функций как входные токены. Playground не исполняет ваши пользовательские функции.

Мультимодальный ввод и безопасность

Элемент contents[].parts[] содержит ровно один вид полезных данных: текст, встроенные медиа, ссылку на файл, вызов/ответ функции или часть выполнения. Он также может содержать подпись или метаданные медиа. На вход поддерживаются текст, изображения, аудио, видео и PDF; на выходе — только текст. Модель не генерирует изображения или аудио и не поддерживает Live API.

Для встроенных байтов используйте inlineData.mimeType и base64 data. Для ссылок на файлы — fileData.mimeType и fileUri. Синтаксически корректный URL не доказывает, что модель может получить его содержимое. Метаданные видео могут задавать смещения начала и конца и положительный fps не выше 24. Агентное понимание видео выбирается для каждой части через mediaProcessing: "AGENTIC" рядом с fileData или inlineData видео; по умолчанию используется статическая обработка. videoMetadata содержит только startOffset, endOffset и fps.

Настройки безопасности используют официальный нативный формат и передаются через API без изменений. В Playground для всех четырёх категорий необходимо задать BLOCK_MEDIUM_AND_ABOVE или более строгий уровень; более низкие пороги доступны только через API.

Ответы JSON и потоковая передача

generateContent возвращает нативный JSON. streamGenerateContent?alt=sse передаёт нативный JSON в событиях SSE data:. Основные поля: candidates[].content.parts, finishReason, continuationToken, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId и usageMetadata.

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

Использование токенов и цены

promptTokenCount включает кэшированный вход. cachedContentTokenCount оплачивается по тарифу кэшированного входа и не начисляется повторно как некэшированный вход. Оплачиваемый выход включает candidatesTokenCount и thoughtsTokenCount. Gemini 4 Carbon тратит больше токенов рассуждений за ход, чем Gemini 4 Argon, поэтому для одного и того же промпта ожидайте большего расхода выходных токенов.

У этой модели нет ценовой ступени по длине контекста. Flex и Priority — отдельные уровни обработки. Результат с указанным Standard не должен оплачиваться с надбавкой Priority; если при запросе Priority ответ не подтверждает фактический уровень, действуют тарифы токенов Standard. Grounding с Google Search и Maps оплачивается за каждый поисковый запрос, отдельно от токенов генерации. Неудачные запросы не оплачиваются. См. таблицу актуальных цен.

Группы аккаунтов

Выберите доступную группу в Playground или используйте необязательный заголовок API с точным именем группы:

X-SeedRouter-Group: GROUP_NAME

Выбранная группа определяет цену и доступную мощность; явный выбор не вызывает скрытого переключения на другую группу. Пропустите заголовок или укажите auto, чтобы сохранить стандартное поведение API-ключа.

Проверьте доступные вашему API-ключу группы без генерации ответа:

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-carbon" \
  -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

Статус проверки

Элементы управления и документация следуют официальному нативному формату. Параметры проверяет Gemini API. Запросы в рабочей среде 11 ноября 2026 года (по одной попытке) дали следующие результаты:

Уровни обработки, mediaProcessing: "AGENTIC" и токены продолжения требуют дополнительной проверки после выхода текущего релиза в рабочую среду. Измеренное сравнение качества или задержки с Gemini 4 Argon не заявляется.

Источники

• Спецификация модели Google
• Что нового в Gemini 4 Carbon
• Поэтапная генерация длинного ответа с generateContent
• Рассуждения
• Цены
• Справочник REST GenerateContent