Claude Opus 5.5을(를) SeedRouter에서 사용할 수 있습니다

Text

Gemini 4 Neon

View Markdown

네이티브 Gemini 요청, 네 가지 사고 수준, 이어서 생성 토큰을 사용하는 긴 답변 분할 생성, 도구, 멀티모달 입력 및 스트리밍입니다. 모델 제한 사항과 검증 상태를 포함합니다.

네이티브 Gemini 형식으로 gemini-4-neon을 사용하세요. 모델 페이지에는 Playground와 현재 요금이 있습니다. Gemini 4 Neon은 Gemini 4 Hydrogen과 Gemini 4 Carbon 사이에 위치하며 같은 네이티브 generateContent 요청 형식을 사용합니다. Google의 마이그레이션 가이드에 따르면 Gemini 4 모델 간에 이동할 때 요청 스키마를 변경할 필요가 없습니다.

모델 ID

모델 ID컨텍스트 윈도우기본 사고 수준
gemini-4-neon입력, 사고 및 출력이 공유하는 1,048,576 토큰high

Default 등급에는 gemini-4-neon을 사용하거나, 모델 검색에서 반환된 명시적 gemini-4-neon:GROUP_NAME 등급을 선택하세요. 요청을 보내기 전에 사용 가능한 등급을 확인하세요.

빠른 예제

curl https://api.seedrouter.ai/v1beta/models/gemini-4-neon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Audit this payment retry queue for race conditions and propose lock acquisition steps."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":65536}}'

모델은 URL에 지정합니다. contents는 필수입니다. 답변에는 네이티브 candidates, finishReason 및 usageMetadata가 포함됩니다. 대화 기록에 thoughtSignature를 포함한 전체 콘텐츠 파트를 보존하세요. 어려운 프롬프트는 몇 분이 걸릴 수 있습니다. Google은 클라이언트 제한 시간을 20분으로 설정할 것을 권장합니다. 준비되는 대로 출력을 받으려면 스트리밍을 사용하세요.

엔드포인트

작업엔드포인트
JSON 응답POST /v1beta/models/gemini-4-neon:generateContent
서버 전송 이벤트POST /v1beta/models/gemini-4-neon:streamGenerateContent?alt=sse

OpenAPI 사양에는 모든 중첩 요청 및 응답 스키마가 포함됩니다. 선택 필드를 생략하면 API 기본값이 적용됩니다. 공개 네이티브 API는 제출된 본문을 보존하여 Gemini가 검증하도록 합니다. Playground는 제출 전에 문서화된 제약 조건도 확인하고 안전 설정을 적용합니다.

요청 매개변수

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

필드유형필수기본값과 제약 조건
contentsobject[]예비어 있지 않은 대화이며 각 content에는 비어 있지 않은 parts가 있어야 합니다
systemInstructionobject아니요텍스트 파트만 사용하며 사용자 신원은 자동으로 삽입되지 않습니다
generationConfigobject아니요다음 표의 생성 매개변수
toolsobject[]아니요함수 선언과 내장 도구 설정
toolConfigobject아니요함수 선택과 검색 설정
safetySettingsobject[]아니요범주당 하나의 설정이며 범주는 중복될 수 없습니다
serviceTierstring아니요unspecified, standard, flex, priority; 일반 처리는 standard입니다
continuationTokenstring아니요finishReason: CONTINUATION 또는 MAX_TOKENS와 함께 반환되는 토큰입니다. 같은 요청에 넣어 다시 보내면 긴 답변을 이어서 생성합니다
labelsobject아니요문자열 값이며 키와 값은 소문자, 각각 최대 63 Unicode 코드 포인트입니다
modelstring아니요선택 리소스 이름이며 실제 모델은 URL이 결정합니다
storeboolean아니요범용 요청 저장 선호 설정이며 모델별 효과는 미검증입니다

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

생성 매개변수

generationConfig의 필드유형기본값과 제약 조건
maxOutputTokensinteger기본값은 사고를 포함해 65,536입니다. 이어서 생성하면 최대 1,048,576에서 입력을 뺀 양까지 가능합니다. 각 스트리밍 또는 비스트리밍 응답은 최대 65,536 토큰을 지원하며 더 긴 출력에는 이어서 생성을 사용합니다
thinkingConfigobjectthinkingLevel: low, medium, high, xhigh(기본값 high); 대문자 표기도 허용합니다. includeThoughts: boolean, 기본값 false입니다. thinkingLevel을 사용하세요. 사용이 권장되지 않는 thinkingBudget은 단독 제공 시 경고와 함께 수준으로 매핑되며 thinkingLevel과 함께 사용할 수 없습니다
stopSequencesstring[]최대 5개 시퀀스
responseMimeTypestring기본값 text/plain; 기존 JSON 스키마 출력에는 application/json이 필요합니다
responseSchemaobject공식 스키마 방언이며 responseJsonSchema와 상호 배타적입니다
responseJsonSchemaJSONJSON Schema이며 responseSchema와 상호 배타적입니다
responseFormatobject텍스트 형식 설정: text.mimeType 및 선택적 text.schema. 스키마에는 JSON MIME 유형이 필요합니다
responseModalitiesstring[]텍스트만 허용: TEXT; 비어 있으면 텍스트입니다
mediaResolutionenumMEDIA_RESOLUTION_UNSPECIFIED 및 MEDIA_RESOLUTION_ 접두사가 붙는 LOW, MEDIUM, HIGH
seedinteger부호 있는 32비트 값이며 모델별 결정적 동작은 미검증입니다
presencePenaltynumber범용 필드이며 모델별 효과와 범위는 미검증입니다
frequencyPenaltynumber범용 필드이며 모델별 효과와 범위는 미검증입니다
responseLogprobsboolean범용 필드이며 이 모델의 가용성은 미검증입니다
logprobsinteger0–20; responseLogprobs: true가 필요하며 모델 지원은 미검증입니다
enableEnhancedCivicAnswersboolean범용 필드이며 모델 지원은 미검증입니다
enableAffectiveDialogboolean범용 필드이며 모델 지원은 미검증입니다
audioTranscriptionConfigobject범용 필드이며 모델별 옵션은 미검증입니다
translationConfigobject범용 필드이며 모델별 옵션은 미검증입니다

OpenAPI 문서에는 v1beta 디스커버리 사양의 audioMetadata, documentMetadata, spreadsheetMetadata 및 videoMetadata.contentLayers를 포함해 각 메시지의 중첩 유형, 열거형, 필수 속성 및 문서화된 경계가 나열되어 있습니다. 스키마는 공식 매개변수를 설명하며 SeedRouter 요청 허용 목록이 아닙니다. 호출자가 제공한 필드와 값은 보존됩니다. 스키마가 필드를 허용한다고 모든 계정에서 지원된다는 뜻은 아닙니다. minimal 사고는 명시된 수준에 없습니다. Google은 temperature, topP, topK 및 candidateCount가 사용이 권장되지 않아 제거해야 한다고 명시하며, 범위 내 사용자 지정 샘플링 값은 무시되고 범위를 벗어난 값은 400을 반환합니다. 네이티브 JSON으로 제출해도 Gemini API가 처리하도록 그대로 전달됩니다.

긴 답변 분할 생성

Gemini 4 Neon의 응답 한 회는 스트리밍에서 최대 65,536 토큰, 비스트리밍에서도 최대 65,536 토큰을 반환합니다. 더 생성하려면 maxOutputTokens를 65,536보다 크게 설정하고 직접 답변을 이어서 생성하세요.

  1. 요청을 보냅니다. 응답이 finishReason: "CONTINUATION"으로 끝나면 candidates[0].continuationToken을 읽습니다.
  2. 그 값을 최상위 continuationToken 필드에 넣어 같은 요청을 다시 보냅니다. 부분 출력을 contents에 추가하지 마세요. 토큰에는 사고를 포함한 모델의 상태가 담깁니다.
  3. finishReason이 STOP 또는 MAX_TOKENS가 될 때까지 반복합니다. 호출이 MAX_TOKENS에 도달하고 continuationToken을 반환한 경우, maxOutputTokens를 늘려야만 재개할 수 있습니다. 같은 한도를 반복하면 400 INVALID_ARGUMENT가 반환됩니다.
{
  "contents": [{"role": "user", "parts": [{"text": "Generate a complete multi-module migration specification and verification checklist for this payment service."}]}],
  "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": 65536,
    "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와 선언된 이름이 필요합니다. 선언된 도구 없이 시스템 지시로 모델에 원시 텍스트 JSON 도구 호출을 출력하도록 요청하지 마세요. MALFORMED_FUNCTION_CALL이 반환될 수 있습니다.

애플리케이션이 반환된 함수를 실행하고 다음 대화 턴에서 결과를 제공합니다. 원래의 thoughtSignature, 함수 호출 및 함수 응답을 각각 보존하세요. 병렬 functionCall 파트 간에 사고 서명을 복사하지 말고, 불투명한 함수 인수를 직렬화할 때 숫자 식별자를 반올림하지 마세요.

Google은 Gemini 4 Neon에 Search, Maps, 코드 실행, URL 컨텍스트, File Search 및 Computer Use를 명시합니다. File Search 리소스는 요청을 처리하는 인증 정보로 접근할 수 있어야 합니다. 네이티브 MCP 설정은 범용 스키마에 있지만 이 모델에서 사용할 수 있는지는 확립되지 않았습니다. 미디어와 함께 사용하기 전에 각 도구의 공식 제한을 확인하세요. 그라운딩을 사용하면 Google은 내부 도구 지시와 함수 선언을 입력 토큰으로 계산합니다. Playground는 사용자 지정 함수를 실행하지 않습니다.

멀티모달 입력과 안전

contents[].parts[]의 각 항목에는 텍스트, 인라인 미디어, 파일 참조, 함수 호출/응답 또는 실행 파트 중 정확히 하나의 페이로드가 들어갑니다. 서명이나 미디어 메타데이터(videoMetadata, audioMetadata, documentMetadata, spreadsheetMetadata, mediaResolution, mediaProcessing)도 포함할 수 있습니다. 입력은 텍스트, 이미지, 오디오, 동영상 및 PDF를 지원하며 출력은 텍스트뿐입니다. 모델은 이미지나 오디오 생성 및 Live API를 제공하지 않습니다.

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

안전 설정은 공식 네이티브 형식을 사용하며 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 Neon의 기본 사고 수준은 high입니다. 다른 모델과 사용량을 비교할 때는 수준을 명시하세요.

이 모델에는 컨텍스트 길이에 따른 요금 구간이 없습니다. 현재 SeedRouter 요금은 Standard 토큰 요율을 사용하며 이 통합에는 Flex 할인과 Priority 할증이 설정되지 않았습니다. 해당 처리 등급의 지원은 여전히 검증이 필요합니다. Google Search 그라운딩은 토큰 사용량 외에 쿼리당 요금을 추가할 수 있으므로 활성화 전에 도구 요금을 확인하세요. 실패한 요청은 과금되지 않습니다. 실시간 가격표를 참조하세요.

계정 그룹

Default 등급은 접미사 없는 gemini-4-neon 모델 ID를 사용합니다. 추가 등급은 URL에서 gemini-4-neon:GROUP_NAME을 사용합니다. Playground는 사용 가능한 등급을 선택하며 API에는 다음 헤더를 명시할 수도 있습니다.

X-SeedRouter-Group: GROUP_NAME

선택한 그룹이 가격과 사용 가능한 용량을 결정합니다. 명시적으로 선택하면 다른 그룹으로 조용히 전환되지 않습니다. 헤더를 생략하거나 auto를 사용하면 API 키의 기본 동작이 유지됩니다.

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

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

검증 상태

공식 문서와 REST 디스커버리 리비전 20261119를 2026년 11월 20일에 확인했습니다. 당일 읽기 전용 모델 검색(GET /v1/models), 그룹 검색(GET /api/seedrouter/llm/groups?model=gemini-4-neon) 및 공개 가격(GET /v1/pricing)을 통해 Default gemini-4-neon 등급과 명시적 gemini-4-neon:googlellm-vertext 등급을 모두 확인했습니다. 또한 api.seedrouter.ai를 통한 각 한 번의 유료 스모크 호출 세 건이 HTTP 200으로 완료되었습니다. Default에서 low 사고를 사용한 JSON 생성(프롬프트 54, 출력 28, 사고 39 토큰), Default에서 xhigh 사고를 사용한 SSE 스트리밍(프롬프트 50, 출력 13, 사고 207 토큰) 및 gemini-4-neon:googlellm-vertext에서 low 사고를 사용한 선언된 functionCall(프롬프트 95, 출력 22, 사고 49 토큰, thoughtSignature 반환)입니다. 네이티브 본문 패스스루와 응답 필드 허용 목록 적용에는 업데이트된 백엔드 빌드 배포가 필요합니다. 미디어 이해, 그라운딩, Computer Use, 이어서 생성/긴 답변 분할 생성, 기타 일반 필드 및 처리 등급은 여전히 미검증 상태이며, 이 확인은 비교 품질이나 지연 시간을 입증하지 않습니다.

참고 자료