소개
Carbon에는 OpenAI 채팅 형식으로 텍스트와 이미지를 전달하고 응답, 함수 호출 또는 JSON을 받습니다. 추론은 답변 전에 진행되며 max_tokens를 사용하므로 예상 길이보다 훨씬 큰 상한을 설정해야 합니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 텍스트 |
| 공유 컨텍스트 | 1,048,576토큰 |
| max_tokens 상한 | 65536 |
핵심 기능 및 하이라이트
어려운 문제를 위한 모델
Google은 다단계 디버깅과 열린 연구에서 Carbon을 Gemini 4 Argon보다 위에 두면서도, 일상적인 엔지니어링 작업 대부분에는 Argon이 여전히 적합하다고 설명합니다.
스스로 검증하는 데 토큰을 사용
Carbon은 가벼운 모델보다 추론과 검증에 더 많은 토큰을 사용하므로 짧은 답변 앞에도 보이지 않는 작업 단계가 길게 이어집니다.
문제 전체를 담는 하나의 창
로그, 소스 파일, 메모는 추론 및 응답과 함께 1,048,576토큰 컨텍스트를 공유합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
messages | 예 | Carbon과의 대화를 오래된 순서대로 보냅니다. user 메시지에서는 텍스트 파트와 |
max_tokens | 아니요 | Carbon의 응답 예산으로 1부터 65536까지 지정하며 기본값은 4096입니다. 추론도 여기에 포함되며 긴 입력에 상한 400을 적용하면 397토큰이 추론에 쓰이고 본문이 반환되지 않았습니다. |
reasoning_effort | 아니요 | Carbon의 사고 깊이로 low, medium, high 중에서 선택하며 기본값은 medium입니다. 사고는 끌 수 없으며 high가 토큰을 가장 많이 사용합니다. |
stop | 아니요 | 중지 문자열을 1개에서 4개까지, 각각 최대 32자로 지정합니다. Carbon의 응답은 첫 번째 일치 직전에 끝나며 일치한 문자열은 반환되지 않습니다. 1자 이상 · 1개 이상 · 4개 이하 |
temperature | 아니요 | OpenAI 방식 클라이언트가 계속 동작하도록 0부터 2까지의 값을 받습니다. Google 문서에 따르면 Carbon은 이 설정을 무시하므로 응답은 달라지지 않습니다. |
top_p | 아니요 | OpenAI 방식 클라이언트가 계속 동작하도록 0.01부터 1까지의 값을 받습니다. Google 문서에 따르면 Carbon은 이 설정도 무시합니다. |
tools | 아니요 | Carbon이 호출을 요청할 수 있는 함수를 최대 128개까지 정의합니다. 애플리케이션이 인수를 검증하고 함수를 실행한 뒤 결과를 tool 메시지로 돌려줍니다. 128개 이하 |
parallel_tool_calls | 아니요 | 기본으로 켜져 있어 Carbon이 한 턴에 여러 함수를 요청할 수 있습니다. 한 번에 하나씩 받으려면 false로 설정하십시오. 기본값: |
tool_choice | 아니요 | Carbon의 다음 동작을 auto, none, required 또는 지정한 함수 하나로 제어합니다. |
response_format | 아니요 | Carbon에 JSON 객체 또는 제공한 json_schema를 따르는 JSON을 요청합니다. 애플리케이션에서 사용하기 전에 결과를 검증하십시오. |
요금
입력 $2 / 출력 $10 100만 토큰당
활용 사례
여러 서비스에 걸친 버그 추적하기
오류 로그와 관련 코드를 붙여 넣고 가능성 높은 원인의 순위와 각 원인을 배제할 확인 방법을 Carbon에 요청합니다.
과학적 논증 검증하기
유도 과정이나 방법 섹션을 전달하고 명시되지 않은 가정에 의존하는 부분이 어디인지 Carbon에 묻습니다.
프롬프트 가이드 및 실전 팁
max_tokens에 충분한 여유 두기
Carbon의 추론은 답변과 동일한 예산을 소모합니다. 긴 입력에 상한 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와 빈 응답으로 호출이 끝납니다.
user 메시지에는 image_url 파트를 넣을 수 있습니다. Carbon은 tools에 선언한 함수의 호출을 요청할 수 있고 response_format으로 JSON을 반환합니다.
Carbon 요청에는 Google의 안전 시스템이 적용되므로 일부 프롬프트는 거부될 수 있습니다.
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 레퍼런스에서 확인하세요.













