Gemini 4 Carbon

네이티브 Gemini 형식으로 gemini-4-carbon을 사용합니다. 모델 페이지에는 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를 사용하세요. 예제는 Google의 권장에 따라 클라이언트 시간 제한도 15분으로 설정합니다.

엔드포인트

OpenAPI 사양에는 모든 중첩 요청 및 응답 스키마가 포함됩니다. 선택 필드를 생략하면 API 기본값을 사용합니다. SeedRouter는 알 수 없는 필드를 필터링하거나 미지원 필드를 제거하거나 모델 매개변수 값을 검증하지 않고 제출된 본문을 전달합니다. 요청 수락 여부는 Gemini API가 결정합니다.

요청 매개변수

URL에서 모델은 gemini-4-carbon으로 고정됩니다. 요청 규약에는 최상위 필드 11개가 있습니다. 필수로 표시한 필드 외에는 모두 선택 사항이며 생략과 JSON null은 다릅니다. 공식 스키마가 허용하는 곳에서는 null을 허용하는 임의의 JSON이 보존됩니다.

Gemini 4 Carbon은 명시적 컨텍스트 캐싱(cachedContent 및 cachedContents 리소스)을 지원하지 않습니다. 프롬프트가 4,096 토큰 이상이면 암시적 캐싱이 기본으로 켜집니다.

생성 매개변수

OpenAPI 문서는 각 메시지의 중첩 유형, 열거형, 필수 속성 및 문서에 명시된 범위를 나열합니다. 스키마는 공식 매개변수를 설명하며 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는 각 회를 별도 요청으로 과금합니다. Interactions API의 서버 측 background 모드는 이 엔드포인트에 포함되지 않습니다.

구조화된 출력

{
  "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을 지정해야 합니다. 해당 메시지에서는 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 제한을 확인하세요. 그라운딩을 사용할 때 Google은 내부 도구 지침과 함수 선언을 입력 토큰으로 계산합니다. Playground는 자체 함수를 실행하지 않습니다.

멀티모달 입력과 안전

contents[].parts[] 항목에는 텍스트, 인라인 미디어, 파일 참조, 함수 호출/응답, 실행 파트 중 정확히 하나의 페이로드가 들어갑니다. 서명이나 미디어 메타데이터를 추가로 포함할 수도 있습니다. 입력은 텍스트, 이미지, 오디오, 동영상, PDF를 지원하며 출력은 텍스트만 지원합니다. 이 모델은 이미지나 오디오 생성 기능이 없고 Live API도 없습니다.

인라인 바이트에는 inlineData.mimeType과 base64 data를 사용합니다. 파일 참조에는 fileData.mimeType과 fileUri를 사용합니다. 구문이 유효한 URL이라고 해서 모델이 가져올 수 있다는 뜻은 아닙니다. 동영상 메타데이터에는 시작/종료 오프셋과 24 이하의 양수 fps를 지정할 수 있습니다. 에이전트형 동영상 이해는 동영상의 fileData 또는 inlineData 옆에 mediaProcessing: "AGENTIC"을 지정해 파트별로 선택하며, 기본값은 정적 처리입니다. videoMetadata에는 startOffset, endOffset 및 fps만 들어갑니다.

안전 설정은 공식 네이티브 형식을 사용하며 API를 통해 변경 없이 전달됩니다. Playground에서는 네 카테고리 모두 BLOCK_MEDIUM_AND_ABOVE 이상으로 엄격하게 설정해야 합니다. 더 낮은 차단 기준은 API에서만 사용할 수 있습니다.

JSON 응답과 스트리밍

generateContent는 네이티브 JSON을 반환합니다. streamGenerateContent?alt=sse는 SSE data: 이벤트에 네이티브 JSON을 전송합니다. 주요 필드로 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 토큰 요율을 적용합니다. Google Search 및 Maps 그라운딩은 생성 토큰과 별도로 쿼리당 과금됩니다. 실패한 요청에는 요금이 부과되지 않습니다. 실시간 요금표를 확인하세요.

여러 계정 그룹

Playground에서 사용 가능한 그룹을 선택하거나 선택적 API 헤더에 정확한 그룹 이름을 지정하세요.

X-SeedRouter-Group: GROUP_NAME

선택한 그룹이 요금과 가용 처리 용량을 결정합니다. 명시적 선택 시 다른 그룹으로 조용히 바뀌지 않습니다. API 키의 기본 동작을 유지하려면 헤더를 생략하거나 auto를 사용하세요.

응답을 생성하지 않고 API 키에서 사용 가능한 그룹을 확인합니다.

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

검증 상태

컨트롤과 문서는 공식 네이티브 형식을 따릅니다. 매개변수 검증은 Gemini API가 담당합니다. 2026년 11월 11일 프로덕션 요청(각 한 번)에서 다음 결과를 확인했습니다.

처리 등급, mediaProcessing: "AGENTIC" 및 이어서 생성 토큰은 현재 릴리스가 프로덕션에 반영된 후 추가 확인이 필요합니다. Gemini 4 Argon과 품질이나 지연 시간을 실측 비교했다는 주장은 하지 않습니다.

참고 자료

• Google 모델 사양
• Gemini 4 Carbon 변경사항
• generateContent를 이용한 긴 답변 분할 생성
• 사고
• 요금
• GenerateContent REST 참조 문서