11월 18일 Google이 Gemini 4 Neon을 연 뒤, Interactions JSON에서 thinking_level, background, usage를 어떻게 두고 가이드의 xhigh와 Antigravity의 400을 어떻게 다루나

깊이는 thinking_level이 정한다. 긴 출력은 background와 store가 정한다. 11월 18일 API 가이드에는 xhigh가 있다. 11월 18–19일 Antigravity CLI 보고는 그 수준에 400을 반환한다.

모델 id만으로는 생각의 깊이도, 긴 출력을 잇는 방법도 정해지지 않는다. 2026년 11월 18일 Google이 Gemini 4 Neon을 열었다. id는 gemini-4-neon이다. Interactions API에서 generation_config.thinking_level은 low, medium, high, xhigh를 받는다. 기본값은 high다. thinking_budget과 minimal은 HTTP 400을 반환한다. 서버가 관리하는 긴 출력은 background와 store를 true로 두고, 한 세그먼트를 넘기면 max_output_tokens를 65536보다 크게 둔다.

이 페이지의 날짜는 2026년 11월 19일이다. 근거는 11월 18일 출시 글, 2026년 11월 18일 UTC에 마지막으로 갱신된 개발자 가이드, 11월 18–19일 Google AI 포럼의 Antigravity 글이다. 어제의 글은 GPT-6.2 Astra와 Sol이다. 이 사이트의 Gemini 4 Carbon 요청을 그대로 보내면 기본 수준을 바꾸고, thinking_budget은 경고가 아니라 400이 된다.

11월 18일에 열린 것

출시 글의 가격은 100만 토큰당 입력 $3, 캐시 입력 $0.15, 출력 $15다. 캐시 가격은 입력의 95% 할인다. API 창은 입력과 출력이 함께 쓰는 1,048,576토큰이다. 이 예산의 출력에는 생각, 함수 호출, 보이는 답이 들어간다. Antigravity 제품 글은 그 앱을 최대 512K 토큰으로 적는다. 숫자는 실제로 호출하는 면의 것을 쓴다.

가격, 100만 토큰당미국 달러
입력$3
캐시 입력$0.15
출력, 생각 토큰 포함$15

출시 글이 여는 곳은 AI Studio와 Android Studio의 유료 Gemini API, Gemini for business, 유료 Google AI Pro와 Ultra의 Antigravity와 Gemini 앱이다. Cloud 가이드는 위치 global, us, eu를 더하고, Agent Platform 접근을 일부 지역의 확인된 기업 고객으로 적는다. Antigravity 요금제 표에는 유료 Pro와 Ultra의 Neon이 있다. Free와 Google AI Plus 행에는 Neon이 없다. Pro 체험은 해당하는 프리미엄 기기로 제한된다. 기업은 Gemini for business를 통해 Neon을 쓴다. 같은 글의 기업 행에는 Orchestrator (Neon)이 없다.

Google은 xhigh의 Artificial Analysis Intelligence Index를 61, 전체 3위, 기본 high의 작업당 비용은 Carbon보다 약 32% 낮다고 보고한다. 수치는 Google의 것이다. 마이그레이션 노트는 일상 에이전트 루프를 gemini-4-hydrogen에, 대량 분류를 gemini-3.5-flash-lite에, Fairwind 사이버보안 시험을 gemini-4-carbon-cyber-permissive에 둔다. 그 프로그램을 위한 Neon 보안 모델은 다른 모델 경로다. gemini-4-neon의 thinking_level은 low, medium, high, xhigh로 남는다.

thinking_level, 그리고 xhigh의 400

Interactions 본문은 소문자를 쓴다. GenerateContent REST는 같은 제어를 generationConfig.thinkingConfig.thinkingLevel로 쓰고, 열거형은 대문자 LOW, MEDIUM, HIGH, XHIGH다. 아래 Interactions 본문은 기본값이다.

{
  "model": "gemini-4-neon",
  "input": "Review the retry path and name the lock that can deadlock.",
  "generation_config": {
    "thinking_level": "high"
  }
}
thinking_levelNeon 가이드가 맡기는 작업
xhigh / XHIGH증명, 과학 분석, 가장 어려운 여러 파일 공학
high / HIGH기본. 여러 단계 도구 루프, 코드, 리팩터, dense한 멀티모달
medium / MEDIUM일반 코딩, 도구, 문서 질문, 영상, 지연이 중요한 턴
low / LOW분류, 라우팅, 요약, 구조화 메타데이터

필드를 빼면 서버는 high를 쓴다. Carbon, Argon, gemini-3.8-flash의 기본은 medium이었다. 그 지연을 유지하는 이전은 medium을 명시한다. thinking_budget은 HTTP 400이다. minimal과 MINIMAL도 HTTP 400이다. max_output_tokens가 1,048,576을 넘으면 HTTP 400이다.

Antigravity 포럼 글은 CLI에서 --model gemini-4-neon-xhigh 또는 --effort xhigh로 수준을 고른다. 그 모델 문자열은 Antigravity의 것이다. Interactions의 model은 gemini-4-neon으로 두고 수준은 thinking_level에 쓴다. 같은 포럼의 개발자는 CLI 1.5.11이 gemini-4-neon-xhigh에 INVALID_ARGUMENT 400, Thinking level is unsupported: THINKING_LEVEL_XHIGH를 반환한다고 보고했다. agy models에 id가 있어도 같다. 11월 18일자 API 가이드는 여전히 xhigh를 적는다. 그 400이 돌아오면 문서의 기본값 high를 보내고, 이어 쓰는 모든 세그먼트에서 같은 수준을 유지한다.

background, continuation_token, status

포그라운드 한 세그먼트는 출력 65,536토큰에서 멈춘다. 스트림과 단일 응답이 같다. 이 한도의 출력에는 생각, 함수 호출, 보이는 답이 들어간다. max_output_tokens를 빼면 예산도 65,536이다. 더 긴 턴은 max_output_tokens를 65536보다 크게, 입력 토큰을 뺀 1,048,576까지 둔다. continuation_token은 v1beta1에 있다. v1에는 이어 쓰기 토큰이 없다.

Interactions에서 status가 requires_continuation이면 세그먼트가 max_output_tokens 전에 65,536에 닿았고, 본문에 continuation_token이 있다. incomplete는 max_output_tokens 예산을 다 쓴 상태다. 같은 한도로 그 토큰을 다시 보내면 HTTP 400이다. 가이드 문장은 max_output_tokens has already been exhausted다. 다음 요청에서 한도를 올린다. completed는 토큰을 지운다. 아래 background 본문은 서버가 관리하는 루프이고 수준은 xhigh다. xhigh를 거부하는 면에서는 첫 호출과 모든 이어 쓰기에 high를 쓴다.

{
  "model": "gemini-4-neon",
  "input": "Write a complete proof of the prime number theorem.",
  "background": true,
  "store": true,
  "generation_config": {
    "thinking_level": "xhigh",
    "max_output_tokens": 262144
  }
}

status가 queued 또는 in_progress인 동안 폴링한다. 가이드의 폴링 목록에는 completed, incomplete, failed, cancelled도 있다. background: true에는 store: true가 필요하다. 저장된 이어 쓰기는 토큰을 발급한 세그먼트의 previous_interaction_id와 continuation_token을 보내고 input은 뺀다. thinking_level은 발급 세그먼트와 같게 둔다.

{
  "model": "gemini-4-neon",
  "store": true,
  "previous_interaction_id": "SEGMENT_1_ID",
  "continuation_token": "CONTINUATION_TOKEN",
  "generation_config": {
    "max_output_tokens": 262144,
    "thinking_level": "xhigh"
  }
}

상태가 없는 이어 쓰기는 store를 false로 두고, 원래 input을 다시 보내고, continuation_token을 붙이며, previous_interaction_id는 뺀다. 루프는 store: true에서 store: false로 옮길 수 있다. 반대 방향에는 previous_interaction_id의 저장된 부모가 없다. 새 사용자 턴은 previous_interaction_id와 새 input이 있고 continuation_token이 없는 요청이다. 세그먼트가 아직 requires_continuation 또는 incomplete이면 HTTP 400이다. completed까지 잇거나, 가장 최근 completed id에서 다음 턴을 시작한다. 이어 쓰기 세그먼트에서 model, system_instruction, tools를 바꾸면 HTTP 400이다. 알려진 문제는 루프 중간의 thinking_level 변경이 검증을 통과한다고 적고, 루프 전체에서 수준과 기본 도구 google_search, code_execution, url_context를 바꾸지 말라고 한다.

GenerateContent는 finish_reason CONTINUATION과 후보의 continuationToken을 준다. 다음 호출은 원래 contents를 다시 보내고 continuationToken을 최상위에 둔다. 수준 열거형은 대문자다.

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Write a complete proof of the prime number theorem."
        }
      ]
    }
  ],
  "continuationToken": "CONTINUATION_TOKEN",
  "generationConfig": {
    "maxOutputTokens": 131072,
    "thinkingConfig": {
      "thinkingLevel": "XHIGH"
    }
  }
}

세그먼트당 제한 시간은 20분이다. 스트림 체크포인트는 출력 65,536토큰에서 시작하고 이후 5,000토큰마다 온다. Interactions 자동 이어 쓰기는 Python google-genai >= 2.34.0, JavaScript @google/genai >= 2.32.0, Go >= 1.77.0, Java >= 1.80.0이 필요하다. GenerateContent 자동 이어 쓰기는 Python >= 2.30.1이 필요하다. previous_interaction_id를 gemini-4-hydrogen에 넘기면 작업 턴이 실행된다. 공개된 Neon 예는 다음 Neon 턴에서 thinking_level을 다시 보낸다. 이 넘김에서 서버는 이전 모델의 서명을 버린다.

요청에서 빼는 필드

temperature, top_p, top_k는 무시된다. frequency_penalty, presence_penalty, 1보다 큰 candidate_count는 HTTP 400이다. candidateCount는 1로 고정된다. cached_content는 제거한다. 암시적 캐시는 4,096토큰부터이고, 지속 캐시는 기본으로 켜져 있으므로 정적 접두사를 앞에 둔다. 기록은 사용자 턴으로 끝난다. 미리 채운 모델 턴은 거부된다.

Word, PowerPoint, Excel, OpenDocument 파일(docx, pptx, xlsx, odt, odp, ods, 그리고 이전 doc, ppt, xls)은 인라인이나 gs:// URI로 보낸다. 함수 응답 안에도 넣을 수 있다. 업로드한 비디오의 기본 media_processing은 static이다. agentic은 켤 때 쓰는 값이다.

첫 functionCall의 thoughtSignature

병렬 도구 턴에서 서명은 첫 functionCall 파트에 둔다. 개발자 가이드의 이름은 thought_signature다. GenerateContent 레퍼런스는 JSON 필드를 thoughtSignature로 적는다. 같은 모델 턴의 두 번째 호출에는 넣지 않는다.

{
  "role": "model",
  "parts": [
    {
      "functionCall": {
        "name": "read_file",
        "args": {}
      },
      "thoughtSignature": "SIG_FROM_MODEL"
    },
    {
      "functionCall": {
        "name": "list_dir",
        "args": {}
      }
    }
  ]
}

활성 턴의 첫 functionCall에 thoughtSignature가 없으면 HTTP 400이다. 형제 functionCall에 복사해도 HTTP 400이다. 호출과 응답을 번갈아 턴으로 나눠도 HTTP 400이다. 이전 서명은 원래 파트에 둔다. 최종 텍스트 파트도 같다. 빼면 MALFORMED_FUNCTION_CALL로 끝날 수 있다. 자리표시자 skip_thought_signature_validator는 추론 맥락을 버린다. 각 함수 응답은 호출의 id, name, 순서와 맞춘다.

$3, $0.15, $15로 읽는 usage

아래 0은 응답의 필드로 바꾼다. 모양은 가이드가 이름을 붙인 Interactions 객체다. 0은 응답이 도착하기 전의 자리표시자다.

{
  "status": "completed",
  "usage": {
    "initial_input_tokens": 0,
    "total_input_tokens": 0,
    "total_cached_tokens": 0,
    "total_output_tokens": 0,
    "total_thought_tokens": 0,
    "total_tokens": 0
  }
}

캐시되지 않은 입력은 total_input_tokens에서 total_cached_tokens를 뺀 값이고 100만당 $3이다. total_cached_tokens는 100만당 $0.15다. total_output_tokens와 total_thought_tokens의 합은 100만당 $15다. 그 합에 total_tokens는 더하지 않는다. 이미 합산된 background 응답에서 initial_input_tokens는 첫 프롬프트이고 이미 total_input_tokens 안에 있다. 청구에 한 번 더 더하지 않는다. 압축을 판단할 때 initial_input_tokens를 쓴다. total_input_tokens는 이어 쓰기 세그먼트마다 커진다. 각 세그먼트가 프롬프트와 이미 만든 토큰을 다시 채우기 때문이다.

자동 이어 쓰기와 background: true는 세그먼트를 가로질러 usage를 이미 합산한다. 직접 만든 루프와 스트림의 interaction.completed는 한 세그먼트의 증분이므로 직접 더한다. GenerateContent SDK는 usage_metadata를 누적하고 initial_prompt_token_count를 남긴다. 직접 만든 REST 루프는 세그먼트별 prompt_token_count, cached_content_token_count, candidates_token_count, thoughts_token_count를 더한다. 끝난 세그먼트는 그 시점에 청구된다. 나중 세그먼트가 실패하거나 취소되어도 같다. Grounding 쿼리는 따로 청구되고, 가이드는 도구 설명과 함수 선언을 처리된 토큰으로 센다.

출시 전에 확인할 JSON

  1. 본문에 gemini-4-neon이 있다. Interactions thinking_level은 low, medium, high, xhigh다. GenerateContent는 대문자 thinkingLevel을 쓴다. 본문에 thinking_budget, minimal, temperature, top_p, top_k, frequency_penalty, presence_penalty, candidate_count, cached_content는 없다.
  2. 65,536토큰을 넘는 호출은 max_output_tokens를 65536보다 크게 두고 v1beta1을 쓴다. background: true는 store: true와 함께 간다. 이어 쓰기 세그먼트는 model, system_instruction, tools, thinking_level을 유지한다.
  3. gemini-4-neon-xhigh 같은 Antigravity id는 그 CLI에 둔다. API 모델 필드는 gemini-4-neon이다. THINKING_LEVEL_XHIGH라고 적힌 400이 오면 그 면에서는 high를 보낸다.
  4. 병렬 도구 파트는 첫 functionCall에만 thoughtSignature를 둔다.
  5. 청구는 캐시되지 않은 입력, 캐시 입력, 출력 토큰, 생각 토큰을 쓴다. total_tokens는 빼 두고, initial_input_tokens를 한 번 더 더하지 않는다.

로컬에서는 JSON 검증, JSONPath($.usage.total_thought_tokens), JSON 비교로 이전 요청과 맞춘다. 업로드하지 않는다.

FAQ

기본값은 여전히 Carbon의 medium인가?

Neon의 기본값은 high다. Carbon, Argon, gemini-3.8-flash의 기본 지연이 필요하면 medium을 보낸다.

thinking_level에 xhigh를 보낼 수 있나?

11월 18일 API 가이드는 Interactions에 xhigh, GenerateContent에 XHIGH를 적는다. 11월 18–19일 Antigravity CLI 보고는 모델 id gemini-4-neon-xhigh에 HTTP 400 Thinking level is unsupported: THINKING_LEVEL_XHIGH를 반환한다. API 본문은 모델 gemini-4-neon과 thinking_level이다. 그 400이 오면 high를 보낸다.

background를 store false와 함께 쓸 수 있나?

가이드는 background true에 store true를 요구한다. 포그라운드의 상태 없는 루프는 store false, 원래 input 재전송, continuation_token으로 잇는다.

청구에 total_tokens를 더하나?

total_tokens는 더하지 않는다. 캐시되지 않은 입력은 100만당 $3, total_cached_tokens는 $0.15, total_output_tokens와 total_thought_tokens의 합은 $15다. initial_input_tokens는 이미 합산된 입력 안에 있다.

병렬 서명은 어디에 두나?

첫 functionCall 파트의 thoughtSignature에만 둔다. 같은 모델 턴의 다른 functionCall에는 넣지 않는다. 형제에 복사하면 HTTP 400이다.

Antigravity 창은 1,048,576토큰인가?

API 가이드의 통합 창은 1,048,576토큰이다. Antigravity의 11월 18일 글은 그 제품에서 최대 512K 토큰이라고 적는다.

요약

11월 18일에 열린 Neon의 가격은 $3, $0.15, $15이고, 생각의 기본은 high다. gemini-4-neon에 thinking_level low, medium, high, xhigh를 보낸다. 한 세그먼트로 부족하면 background: true, store: true, 65536보다 큰 max_output_tokens를 함께 둔다. 병렬 호출에서는 thoughtSignature를 첫 functionCall에만 둔다. Antigravity가 THINKING_LEVEL_XHIGH에 400을 반환하면 그 면에서는 high를 보내고, API 모델 id에는 접미사를 붙이지 않는다.