Gemini 4 Carbon 사용법: 이용 경로, 요청 작성과 한도

Gemini 4 Carbon은 Google이 사이버 보안 방어 담당자에게 처음 공개한 지 2주 뒤인 2026년 11월 10일부터 유료 이용 개발자에게 제공되기 시작했습니다. 요청 모델 ID는 gemini-4-carbon이며, 텍스트, 이미지, 동영상, 오디오, PDF를 입력받고 텍스트를 반환합니다.^[1][2] 10월 말에 작성된 가이드 중에는 아직 이용할 수 없다고 설명하는 경우가 많으므로, 내용을 복사하기 전에 작성 날짜를 확인하십시오.

이 가이드는 현재 Gemini 4 Carbon을 사용하는 방법을 설명합니다. 실행 가능한 서비스, 네이티브 Gemini 형식으로 첫 요청을 작성하는 방법, 이전 Gemini 모델에서 옮겨 올 때 놓치기 쉬운 출력 한도를 다룹니다. reAPI는 이 모델의 추론을 제공하지 않습니다. reAPI의 Gemini 4 Carbon 개요에는 요청 편집기가 있으며, 실제 서비스는 SeedRouter에서 제공됩니다.

핵심 요약

• 개발자는 Gemini API 유료 등급에서 Gemini 4 Carbon을 사용할 수 있으며, 무료 등급에서는 이용할 수 없습니다. Google AI Ultra 구독자는 Gemini 앱, Google Antigravity, 검색의 AI Mode에서도 사용할 수 있습니다.^[1][4]
• Gemini 4 Argon에서 전환할 때는 모델 ID만 바꾸면 됩니다. 다만 Carbon은 턴당 사고 토큰을 더 많이 사용하므로 출력 예산과 클라이언트 타임아웃에 여유를 두십시오.^[5]
• 주요 제어 항목은 thinkingLevel이며, low, medium(기본값), high 중에서 선택합니다. Temperature, top-p, top-k는 무시됩니다.^[5]
• 비스트리밍 REST 호출은 홉당 최대 32,768개의 출력 토큰을 반환합니다. 이어받기 토큰 없이 이보다 많은 출력을 요청하면 400 오류가 반환됩니다.^[6]
• SeedRouter에서 Gemini 4 Carbon은 네이티브 Gemini 형식의 generateContent와 streamGenerateContent를 사용합니다.^[3]

현재 Gemini 4 Carbon을 사용할 수 있는 곳

Google의 11월 10일 발표에는 여러 이용 경로가 나와 있습니다. 각각 별도의 계정을 사용하는 서로 다른 제품이므로, Gemini 앱의 Ultra 구독이 API 키를 제공하는 것은 아니며 유료 API 키로 소비자용 앱을 이용할 수 있는 것도 아닙니다.^[1]

무료 이용 여부를 가장 많이 묻지만, API는 무료로 이용할 수 없습니다. Google 요금 페이지는 무료 등급의 Gemini 4 Carbon 항목을 모두 "이용 불가"로 표시합니다.^[4] 소비자용 서비스를 이용하려면 일반 유료 요금제가 아닌 Ultra가 필요합니다.

이 작업에는 Carbon과 Argon 중 무엇이 적합한가요

Google은 대부분의 소프트웨어 엔지니어링과 지식 업무에 Argon이 적합하다고 설명합니다. Carbon은 대규모 코드베이스에 걸친 다단계 디버깅이나 정해진 답이 없는 연구처럼 모델의 추론 능력을 깊이 요구하는 작업을 위한 모델이며, 탐색과 결과 검증에 Argon보다 더 많은 토큰을 사용합니다.^[1] Google의 마이그레이션 안내도 같은 내용을 실무 관점에서 설명합니다. 더 빠른 응답과 적은 턴당 토큰 사용량이 필요하다면 Argon을 유지하십시오.^[5]

두 모델은 요청 스키마가 같으므로, 클라이언트를 2개 유지하지 않고도 어려운 작업은 gemini-4-carbon으로 보내고 일상적인 트래픽은 gemini-4-argon으로 처리할 수 있습니다. Google은 Carbon 출시 초기 토큰 요금도 Argon과 동일하게 책정했습니다.^[1] Carbon은 더 오래 사고하므로 토큰당 요금이 같아도 동일한 프롬프트의 비용이 더 높을 수 있습니다. 사고 토큰은 출력으로 과금됩니다.^[4]

Google이 명시한 Gemini API 요금은 2026년 11월 30일까지 입력 100만 토큰당 $2, 출력 100만 토큰당 $10이며, 12월 1일부터는 각각 $4와 $20입니다.^[4] 캐시된 입력은 출시 초기 기간에 100만 토큰당 $0.10, 이후에는 $0.20입니다. 이는 Google 자체 API의 요금입니다. 다른 서비스는 자체 요금을 정하므로, SeedRouter에서 실제로 지불할 요금은 해당 모델 페이지에서 확인하십시오.

첫 Gemini 4 Carbon 요청 준비

버그가 확인된 짧은 함수처럼 답을 검증할 수 있는 작업을 선택하십시오. 처음부터 저장소 전체로 시작하면 접근 문제인지, 요청 구성 문제인지, 프롬프트가 부족한 것인지 구분하기 어렵습니다.

네이티브 Gemini 형식에서는 모델을 본문이 아닌 URL 경로에 지정하며, 필수 필드는 contents뿐입니다.^[3] 다음은 POST /v1beta/models/gemini-4-carbon:generateContent의 요청 본문입니다.

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "This retry loop re-reads an account balance before taking the lock. Explain the race condition and propose a fix with one test."
        }
      ]
    }
  ],
  "generationConfig": {
    "thinkingConfig": { "thinkingLevel": "medium" },
    "maxOutputTokens": 32768
  }
}

32768이라는 예산은 이 필드를 명시할 때 최소 32,768로 설정하라는 Google의 권고를 따른 것입니다. Carbon이 한도의 상당 부분을 사고에 사용할 수 있기 때문입니다.^[5] 이 값은 비스트리밍 REST 호출 1회의 상한이기도 하며, 다음 절에서 설명합니다.

SeedRouter 문서는 자체 호스트인 api.seedrouter.ai에서도 같은 경로를 사용하고, Authorization 헤더에 Bearer 토큰을 넣도록 안내합니다. Google 자체 REST 예시는 대신 x-goog-api-key 헤더를 사용합니다.^[3][6] 각 키는 발급한 서비스에서만 사용하십시오. Google 키로는 SeedRouter에서 인증할 수 없으며, SeedRouter 키는 Google 호스트에서 작동하지 않습니다.

Gemini 4 Carbon이 무시하거나 거부하는 설정은 제외하십시오. Google에 따르면 temperature, topP, topK를 보내도 무시되며, 명시적 컨텍스트 캐싱은 지원되지 않습니다. 암시적 캐싱은 4,096토큰 이상의 프롬프트에 자동으로 적용되므로 코드베이스나 긴 문서처럼 크고 고정된 자료는 프롬프트 앞부분에 넣으십시오.^[5] 클라이언트가 이전 모델에서 쓰던 thinkingBudget을 아직 전송한다면 thinkingLevel로 바꾸십시오. Google의 Agent Platform 가이드에 따르면 해당 플랫폼의 Gemini 4 모델에 thinking_budget이나 MINIMAL을 사용하면 HTTP 400이 반환됩니다.^[7]

스트리밍, 출력 상한과 이어받기

Gemini 4 Carbon은 입력, 사고, 출력이 공유하는 1,048,576토큰의 통합 컨텍스트 윈도를 제공합니다. 단일 동기 호출은 그보다 훨씬 낮은 한도에서 멈춥니다.^[2] Google의 long decode 가이드는 홉당 상한을 다음과 같이 정합니다.^[6]

이어받기는 홉 단위로 진행됩니다. 홉이 상한에 도달했지만 예산이 남아 있으면 응답은 finishReason: "CONTINUATION"과 continuationToken을 반환하며 끝납니다. 동일한 요청에 이 토큰을 추가해 다시 전송하십시오. 토큰에 모델 상태가 이미 담겨 있으므로 부분 답변을 contents에 추가하면 안 됩니다. 종료 사유가 CONTINUATION인 동안 계속 이어받으십시오.^[6]

홉에서 빈 텍스트가 반환될 수도 있습니다. 어려운 문제에서는 모델이 홉 전체를 사고에 사용할 수 있으며, Google은 이어받기 토큰과 함께 반환된 빈 text를 실패가 아닌 정상적인 진행으로 취급합니다.^[6]

느린 응답에도 대비하십시오. Google은 long decode에 HTTP 읽기 타임아웃을 20분으로 설정할 것을 권장합니다. SeedRouter는 비스트리밍 요청이 약 100초 이상 실행되면 답변이 도착하기 전에 HTTP 524로 끝날 수 있다고 경고합니다. 긴 작업에는 SeedRouter가 streamGenerateContent?alt=sse를 권장합니다.^[3][6] 연결이 끊겼다고 해서 생성이 실패했다고 단정할 수는 없으므로, 같은 요청을 다시 보내기 전에 부분 결과를 확인하십시오.

사고 강도 선택

thinkingLevel은 품질, 지연 시간, 토큰 사용량 사이의 균형을 조절합니다.^[5]

Google은 세 가지 강도를 모두 직접 평가하고, 품질 기준을 충족하는 가장 낮은 강도를 선택하라고 권고합니다.^[5] Argon에서 잘 작동하던 강도는 출발점으로 삼을 수 있지만, Carbon은 토큰을 사용하는 방식이 다르므로 그대로 확정해서는 안 됩니다.

작업을 늘리기 전에 응답 확인

답변 텍스트 외의 정보도 확인하십시오. 네이티브 응답에는 candidates[].content.parts, finishReason, usageMetadata가 포함됩니다. SeedRouter 문서는 확인할 만한 필드로 continuationToken, safetyRatings, promptFeedback도 명시합니다.^[3]

• finishReason: "MAX_TOKENS"는 출력 예산을 소진했다는 뜻입니다. Google에 따르면 반환된 토큰과 더 높은 maxOutputTokens로 다시 전송하거나, 처음부터 다시 실행하고 두 실행 모두의 비용을 지불할 수 있습니다.^[6]
• thoughtsTokenCount는 출력으로 과금된 사고 토큰 수를 보여 줍니다. 화면에 보이는 답변이 짧아도 그 뒤에 많은 사고 토큰이 사용되었을 수 있습니다.^[4][6]
• REST는 홉별 사용량을 반환합니다. 비용 계산에는 각 홉의 필드를 합산하되, 프롬프트 크기는 첫 홉에서만 가져오십시오.^[6]
• SeedRouter의 스트리밍 사용량은 누적값이므로 모든 청크를 합산하지 말고 가장 최근의 카운터를 읽으십시오.^[3]

대화 기록을 구성할 때는 thoughtSignature를 포함한 콘텐츠 파트 전체를 보존하십시오.^[3] 코드 수정이라면 패치를 채택하기 전에 테스트를 실행하십시오. 200 응답은 서비스가 요청을 수락했다는 사실만 보여 줍니다.

출시 당시 Google이 발표한 결과

Google의 10월 28일 발표에 따르면 Gemini 4 Carbon은 Artificial Analysis Intelligence Index v5.0에서 59점으로 1위를 차지했습니다. Google은 SEC-bench Pro 88.2%, ExploitGym 54.8%, CWE-bench 71.0%를 보고했으며, 모두 가드레일 없이 평가한 결과입니다.^[8] 이는 공급업체가 보고한 결과입니다. 프로덕션 트래픽을 보내기 전에 자체 작업으로 모델을 테스트하십시오.

자주 묻는 질문

Gemini 4 Carbon은 무료인가요?

Gemini API에서는 무료가 아닙니다. Google 요금 페이지는 무료 등급에서 이용할 수 없다고 명시하며, Gemini 앱에서 소비자가 이용하려면 Google AI Ultra 구독이 필요합니다.^[1][4] 연구자는 Antigravity 6개월 무료 이용을 신청할 수 있으며, 선정되어야 합니다.

Gemini 4 Carbon은 지금 사용할 수 있나요?

네. 2026년 11월 10일부터 Gemini API 유료 이용 개발자, Gemini for business, Google AI Ultra 구독자에게 제공됩니다. 그전에는 Fairwind Program의 방어 담당자만 이용할 수 있었습니다.^[1]

Gemini 4 Carbon 요금은 얼마인가요?

Google API에서는 2026년 11월 30일까지 입력 100만 토큰당 $2, 출력 100만 토큰당 $10이며, 이후에는 각각 $4와 $20입니다.^[4] 사고 토큰은 출력으로 계산됩니다. SeedRouter는 자체 요금을 모델 페이지에 공개합니다.

Gemini 4 Carbon의 컨텍스트 윈도는 얼마인가요?

입력, 사고, 출력이 공유하는 1,048,576토큰입니다. 기본 동기 출력 한도는 65,536토큰이며, 비스트리밍 REST 호출은 32,768토큰입니다. long decode를 사용하면 더 길게 생성할 수 있습니다.^[2][6]

Gemini 4 Argon에서 Carbon으로 전환할 수 있나요?

네. Google에 따르면 요청 스키마를 바꿀 필요 없이 모델 ID만 변경하면 됩니다. 사고 시간이 길어지는 점을 고려해 출력 예산과 타임아웃에 여유를 두십시오.^[5]

reAPI에서 Gemini 4 Carbon을 사용할 수 있나요?

아니요. reAPI는 이 모델의 추론, 과금, 키를 제공하지 않습니다. 개요 페이지에서 요청을 준비할 수 있으며, 실행은 SeedRouter에서 합니다.

첫 Gemini 4 Carbon 실행을 위한 준비

작은 작업으로 시작하고, URL에 gemini-4-carbon을 사용하며, thinkingLevel과 maxOutputTokens를 의도에 맞게 설정하십시오. 오래 걸릴 수 있는 작업에는 스트리밍을 사용합니다. 프롬프트를 늘리기 전에 종료 사유와 토큰 수를 확인하십시오. 준비가 되면 SeedRouter의 Gemini 4 Carbon을 열고 계정의 이용 가능 여부를 확인합니다.

참고 자료

1. Google. Gemini 4 Carbon is now available. 2026년 11월 10일 게시, 2026년 11월 11일 확인: blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-4-carbon-now-available.
2. Google AI for Developers. Gemini 4 Carbon model page. 2026년 11월 11일 확인: ai.google.dev/gemini-api/docs/models/gemini-4-carbon.
3. SeedRouter. Gemini 4 Carbon API documentation. 2026년 11월 11일 확인: seedrouter.ai/docs/gemini-4-carbon. 모델 페이지: seedrouter.ai/models/gemini-4-carbon. 이 가이드를 위한 실제 모델 실행 테스트는 하지 않았습니다.
4. Google AI for Developers. Gemini Developer API pricing: Gemini 4 Carbon. 2026년 11월 11일 확인: ai.google.dev/gemini-api/docs/pricing.
5. Google AI for Developers. What's new in Gemini 4 Carbon. 2026년 11월 11일 확인: ai.google.dev/gemini-api/docs/whats-new-gemini-4-carbon.
6. Google AI for Developers. Long decode (generateContent). 2026년 11월 11일 확인: ai.google.dev/gemini-api/docs/long-decode.
7. Google Cloud. Get started with Gemini 4. Gemini Enterprise Agent Platform 문서, 2026년 11월 11일 확인: docs.cloud.google.com/gemini-enterprise-agent-platform/models/start/get-started-with-gemini-4.
8. Google. Gemini 4 Carbon: our next frontier model. 2026년 10월 28일 게시, 2026년 11월 11일 확인: blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-carbon.