Gemini 4 Argon

네이티브 Gemini 형식으로 gemini-4-argon을 사용하세요. 모델 페이지에는 Playground와 현재 요금이 있으며, 출시 가이드에서 이용 가능 범위를 설명합니다.

모델 ID

빠른 예제

curl https://api.seedrouter.ai/v1beta/models/gemini-4-argon:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Explain a mutex in one sentence."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"low"},"maxOutputTokens":256}}'

모델은 URL에 지정합니다. contents는 필수입니다. 응답에는 네이티브 candidates, finishReason, usageMetadata가 포함됩니다. thoughtSignature를 비롯한 전체 콘텐츠 파트를 대화 기록에 유지하세요.

엔드포인트

OpenAPI 명세에는 모든 중첩 요청 및 응답 스키마가 포함됩니다. 선택 필드를 생략하면 API 기본값이 적용됩니다. 알 수 없는 필드와 공식적으로 지원하지 않는 필드는 제거되며, 지원하는 필드에 잘못된 값을 지정하면 오류가 발생합니다.

파라미터

generationConfig에는 maxOutputTokens, thinkingConfig, stopSequences, responseFormat, 기존 responseMimeType/responseSchema/responseJsonSchema, responseModalities, mediaResolution, seed, presencePenalty, frequencyPenalty, responseLogprobs, logprobs, enableEnhancedCivicAnswers, enableAffectiveDialog, translationConfig, audioTranscriptionConfig가 포함됩니다. 모델별 동작이 확인되지 않은 공통 필드는 추가 기능 검증이 필요합니다.

• 사고 수준은 low, medium, high이며 기본값은 medium입니다. 사고를 끌 수는 없습니다. includeThoughts는 사고 요약을 요청합니다. 지원 중단 예정인 thinkingBudget은 단독으로 사용할 수 있지만 thinkingLevel과 함께 설정할 수는 없습니다.
• 입력, 사고, 출력이 1,048,576 토큰을 공유합니다. maxOutputTokens에는 사고가 포함되며, 남은 컨텍스트에 따라 실제 예산이 줄어들 수 있습니다.
• 네이티브 REST의 요청당 출력 한도와 기본값은 32,768 토큰이며, 스트리밍 시 65,536 토큰입니다. 더 긴 출력은 이어서 생성 요청을 사용합니다. 최초 비스트리밍 요청이 32,768을 초과하는 경우에 대해 공식 문서의 설명이 상충하므로, 이 연동은 해당 값을 전체 생성 한도로 제한하지 않습니다.
• stopSequences는 최대 5개입니다. logprobs의 범위는 0~20이며 responseLogprobs: true가 필요합니다.
• responseSchema와 responseJsonSchema는 동시에 사용할 수 없으며, 둘 다 responseMimeType: "application/json"이 필요합니다. 새 요청은 아래의 responseFormat.text를 사용할 수 있습니다.
• responseModalities에는 TEXT만 포함할 수 있습니다. Temperature, top-p, top-k, 후보 수는 Argon에서 실제로 적용되는 제어 항목이 아닙니다. 명시적 cachedContent, 이미지 생성, 음성 생성은 지원하지 않습니다.

구조화된 출력 및 도구

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 256,
    "responseFormat": {
      "text": {
        "mimeType": "APPLICATION_JSON",
        "schema": {"type": "object", "properties": {"ok": {"type": "boolean"}}, "required": ["ok"]}
      }
    }
  }
}

함수는 tools[].functionDeclarations로 정의합니다. allowedFunctionNames를 사용하려면 모드가 ANY 또는 VALIDATED여야 하며, 선언된 이름을 지정해야 합니다. 함수 호출, 응답, 서명은 원래 순서대로 유지하세요. Google Search, Maps, 코드 실행, URL context, File Search, Computer Use는 공식 기능이지만, 리소스 접근, 요금, 동작은 의도한 작업별로 검증해야 합니다. Playground는 도구를 로컬에서 실행하지 않습니다.

미디어 및 안전 설정

네이티브 parts는 inlineData 또는 fileData를 통해 텍스트, 이미지, 오디오, 동영상, PDF 입력을 받습니다. 각 파트에는 한 종류의 페이로드만 담을 수 있으며, 사고 서명과 미디어 메타데이터를 함께 넣을 수 있습니다. 전역 mediaResolution과 파트별 해상도는 서로 다른 설정입니다. 동영상은 STATIC 및 AGENTIC 처리를 지원하며, videoMetadata.fps는 0보다 크고 24 이하여야 합니다.

Playground는 최대 12 MiB의 JSON 요청을 받습니다. 이는 애플리케이션의 전송 한도이며 모델의 미디어 한도가 아닙니다. 큰 미디어는 계정에서 지원하는 파일 참조를 사용하세요. 파일 리소스와 외부에서 가져오는 미디어는 공식 한도가 서로 다르며, 여기서는 아직 이용 가능 여부를 검증하지 않았습니다.

공개 API의 안전 설정은 네이티브 규격을 따릅니다. Playground는 네 가지 주요 안전 범주에 중간 수준 이상의 차단 설정을 요구합니다. 더 낮은 기준은 API에서만 설정할 수 있으며, 관리자에게는 예외가 적용됩니다.

스트리밍 및 이어서 생성

SSE 스트림에서 네이티브 JSON 이벤트를 읽습니다. 도구 및 사고 메타데이터를 포함해 모든 파트를 유지하세요. 한 스트림 안의 사용량 카운터는 누적값이므로, 모든 이벤트를 더하지 말고 마지막 사용량 객체를 사용해야 합니다.

후보가 continuationToken을 반환하면 그대로 유지하세요. CONTINUATION인 경우 원래 contents, 시스템 지시, 도구, 생성 설정을 다시 보내고 최신 토큰을 최상위 수준에 넣습니다. 일부 출력 내용을 contents에 추가하지 마세요. MAX_TOKENS인 경우 재개하기 전에 출력 예산을 늘려야 합니다. Playground는 검토할 수 있도록 이어서 생성 요청을 준비하며, 다시 전송 버튼을 눌러야 요청을 보냅니다.

이어서 생성할 때마다 별도 요청이 발생하며, 각각 사용량과 요금이 계산됩니다. 재연결을 구현하는 경우 체크포인트를 보관하고, 연결이 끊긴 스트림이 완료되었다고 가정하지 마세요. Playground는 모든 필드를 살펴볼 수 있도록 네이티브 응답을 유지합니다.

사용량 및 현재 검증 상태

입력 사용량에는 캐시 입력이 포함되며, 과금 대상 출력에는 후보와 사고 토큰이 포함됩니다. 모델 페이지의 현재 요율과 계정의 사용량 기록을 확인하세요. 실패한 요청에는 요금이 부과되지 않습니다.

2026년 10월 14일 로컬 검증에서는 텍스트 스트리밍, 구조화된 JSON, 서명을 포함한 함수 호출 및 결과 회신, 코드 실행, Google Search와 URL context, 이미지·동영상·PDF 이해, 사고 출력, 중지 시퀀스를 확인했습니다. 오디오 입력은 수락되었지만 샘플의 일부가 잘못 전사되었습니다.

logprobs는 명시적으로 거부되었습니다. maxOutputTokens: 32769를 지정한 요청은 JSON 및 SSE 검증에서 모두 실패했습니다. 유효한 continuationToken과 유효하지 않은 토큰 모두 답변을 반환했으므로, 정상적인 이어서 생성은 아직 검증되지 않았습니다. 서비스 등급 선택값과 seed는 수락되었지만 실제 효과를 입증하는 증거는 없습니다. Maps, File Search, Computer Use, agentic video 및 외부 파일 참조는 아직 테스트하지 않았습니다.

이러한 제한적인 검증만으로 모든 매개변수 조합이나 프로덕션 환경의 이용 가능 여부를 확인할 수는 없습니다. 전체 규격을 사용하려면 네이티브 형식을 사용하세요. OpenAI 호환 형식은 별도의 기능 하위 집합이며 long decode를 지원하지 않습니다.

참고 자료

• 공식 모델 명세
• GenerateContent 마이그레이션 가이드
• 긴 출력 및 이어서 생성
• 구조화된 출력

선택 사항: LLM 그룹 지정

이 모델의 Playground에 로그인하면 사용 가능한 그룹을 확인할 수 있습니다. 선택 가능한 항목은 계정 권한과 선택한 모델에 따라 달라집니다. Playground는 로그인 세션을 사용하므로 API 키를 입력할 필요가 없습니다.

API 호출에는 기존 API 키와 모델 ID를 그대로 사용합니다. 그룹을 선택하려면 선택 사항인 X-SeedRouter-Group 요청 헤더에 정확한 그룹 이름을 지정합니다. 아래의 GROUP_NAME을 Playground에 표시된 이름으로 바꾸세요. 헤더를 생략하거나 auto를 사용하면 키의 기본 동작이 유지됩니다.

X-SeedRouter-Group: GROUP_NAME

제한이 있는 API 키는 Playground보다 선택 가능한 그룹이 적을 수 있습니다. 요청에는 선택한 그룹의 요금이 적용되며, 해당 그룹을 사용할 수 없더라도 다른 그룹으로 전환하지 않습니다. 이 옵션은 SSE를 포함한 HTTP LLM 호출을 지원하며 WebSocket, 이미지 또는 동영상 호출에는 적용되지 않습니다.

모델 응답을 생성하지 않고 특정 API 키에서 사용 가능한 그룹을 확인하려면 이 읽기 전용 엔드포인트를 사용합니다. data[].id는 헤더에 넣을 값이며, ratio는 해당 그룹에서 계정에 적용되는 요금 배율입니다. auto 항목은 현재 기본 설정의 예상값을 나타내며, 사용 가능한 기본 그룹이 없으면 배율은 null입니다. 모델 호출 시 그룹의 사용 가능 여부를 다시 확인합니다.

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