Введение
Отправляйте текст и изображения в чат-формате OpenAI и получайте ответ, вызовы функций или JSON. Рассуждение идёт до результата и расходует max_tokens, поэтому задавайте предел намного выше ожидаемой длины.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Текст |
| Общий контекст | 1 048 576 токенов |
| Предел max_tokens | 65536 |
| Входные данные | текст / изображения |
Ключевые возможности и особенности
Для действительно сложных задач
Google ставит Carbon выше Gemini 4 Argon в многошаговой отладке и открытых исследованиях, но отмечает, что Argon по-прежнему подходит для большей части повседневной инженерной работы.
Тратит токены на самопроверку
Carbon расходует на рассуждение и проверку больше токенов, чем лёгкие модели, поэтому перед коротким ответом ожидайте долгую скрытую фазу работы.
Одно окно на всю задачу
Логи, исходные файлы и заметки делят контекст 1 048 576 токенов с рассуждением и ответом.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
messages | Да | Диалог с Carbon, от старых сообщений к новым. В сообщениях пользователя текст можно дополнять частями |
max_tokens | Нет | Бюджет ответа Carbon от 1 до 65536, по умолчанию 4096. Сюда входит рассуждение: предел 400 при длинном запросе израсходовал 397 токенов на рассуждение и не вернул текст. |
reasoning_effort | Нет | Глубина рассуждения Carbon: low, medium или high, по умолчанию medium. Рассуждение нельзя отключить, а уровень high расходует больше всего токенов. |
stop | Нет | От одной до четырёх стоп-строк длиной до 32 символов каждая. Ответ Carbon заканчивается перед первым совпадением, а само совпадение не возвращается. Не менее 1 символов · Не менее 1 элементов · Не более 4 элементов |
temperature | Нет | Принимает значения от 0 до 2, чтобы клиенты в стиле OpenAI продолжали работать. Согласно документации Google, Carbon игнорирует эту настройку, поэтому ответ не меняется. |
top_p | Нет | Принимает значения от 0,01 до 1, чтобы клиенты в стиле OpenAI продолжали работать. Согласно документации Google, Carbon игнорирует и эту настройку. |
tools | Нет | До 128 определений функций, которые может запросить Carbon. Приложение проверяет аргументы, выполняет функцию и возвращает результат в сообщении tool. Не более 128 элементов |
parallel_tool_calls | Нет | Включено по умолчанию, поэтому Carbon может запросить несколько функций за один ход. Укажите false, чтобы получать по одному вызову. По умолчанию: |
tool_choice | Нет | Определяет следующий шаг Carbon: auto, none, required или одна указанная функция. |
response_format | Нет | Запрашивает у Carbon объект JSON или JSON по заданной вами схеме |
Стоимость
Ввод $2 / Вывод $10 за 1 млн токенов
Сценарии использования
Найти ошибку на стыке сервисов
Вставьте логи со сбоями и связанный код, затем попросите Carbon ранжировать вероятные причины и назвать проверку, исключающую каждую из них.
Проверить научную аргументацию
Передайте Carbon вывод или раздел с методикой и спросите, где рассуждение опирается на невысказанное допущение.
Руководство по промптам и практические советы
Оставляйте большой запас в
max_tokensРассуждение расходует тот же бюджет, что и ответ. В нашем тесте предел 400 токенов при длинном запросе ушёл на рассуждение (397 токенов), и текст не вернулся.
Берегите Carbon для нужных задач
Рутинные правки и поиск отправляйте более лёгкой модели, а Carbon подключайте, когда ошибка обойдётся в реальное время.
Gemini 4 Carbon — самая мощная модель рассуждений Google для сложной отладки, исследований и долгих запусков агентов.
google/gemini-4-carbon/chat — /v1/chat/completions
Задайте reasoning_effort: low, medium или high; по умолчанию Carbon использует medium. Рассуждение расходует max_tokens до появления видимого текста.
Если предел исчерпан во время рассуждения, вызов завершается с finish_reason length и пустым ответом.
Сообщения пользователя могут содержать части image_url. Carbon также может запрашивать функции, объявленные в tools, и возвращать JSON через response_format.
Системы безопасности Google проверяют запросы к Carbon, поэтому некоторые промпты могут быть отклонены.
Быстрый старт API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/gemini-4-carbon/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.













