Gemini 매개변수 및 프로토콜 차이
호환 프로토콜에서 Gemini 모델의 매개변수 차이와 사용 방법을 알아봅니다.
Gemini 추론/도구/캐시는 이 페이지에서 조정하세요. 구조: Generate Content, Stream Generate Content, Chat Completions. 일반/스트리밍 원본 규칙은 같습니다.
| 모델 | 사용 요점 |
|---|
| gemini-4-argon | 원본 강도 LOW/MEDIUM/HIGH, 기본 MEDIUM, 암시적 캐시만, 긴 출력은 이어가기 |
| gemini-3.8-flash | 같은 세 강도, 기본 MEDIUM, 원본 MINIMAL 미지원. 암시/명시 캐시 지원 |
| gemini-3.7-flash | 같은 세 강도, 기본 MEDIUM, MINIMAL 미지원. Google Developer API는 폐기하고 3.8로 전환. Google 서비스 정책이지 플랫폼 종료/자동 대체 아님 |
| 필드 | 차이 설명 |
|---|
thinkingConfig.thinkingLevel | 세 모델 모두 MINIMAL이나 이전의 영 예산으로 추론을 끌 수 없음. 깊이를 낮추려면 LOW을 사용하며 Gemini 2.5의 해제 방식은 적용하지 않음 |
thinkingConfig.thinkingBudget | 신규는 thinkingLevel, 두 필드 동시 불가. Argon Developer API는 이전 예산 단독을 가까운 강도로 매핑하고 경고 |
temperature/topP/topK | 이전 샘플링 무시, 전달 불필요하며 조절 불가 |
candidateCount | Gemini 3 이후 미지원, 요청에서 제거 |
frequencyPenalty/presencePenalty | Google Cloud 3.7 Flash는 전달 시 오류 명시, 위 조용한 무시와 다름 |
thinkingConfig.includeThoughts | 켜면 parts[].thought으로 요약과 답변 구분. 요약은 원본 추론/서명 대체 아님 |
parts[].thoughtSignature | 반환된 Parts 전체 그대로 보존, 도구 이력 서명 필수. 서명 있는/없는 블록을 합치지 않음 |
functionCall/functionResponse | 함수 결과의 id, name을 실제 호출과 하나씩 일치, 병렬 결과 누락/오매칭 금지 |
| model 사전 채우기 | 미완성 model로 끝내지 않음. 3.8은 최종 user에 비어 있지 않은 텍스트 필요 |
maxOutputTokens | 추론과 답변 포함. Argon 직접 REST는 일반 한 구간 32768, 스트리밍 65536, 초과는 이어가기 필요, 숫자만 키워 한 번에 반환 불가 |
continuationToken | 여기서는 Argon만 긴 출력 이어가기. CONTINUATION이면 원래 입력/도구/총예산 유지, 최신 토큰 전달. MAX_TOKENS 이후는 사용 토큰 이상으로 예산 증가. 중간 출력을 contents에 추가하지 않음 |
Google 공식 Chat 호환층 규칙으로 모든 플랫폼 채널이 같은 변환을 쓴다는 뜻은 아닙니다.
| 필드 | 차이 설명 |
|---|
reasoning_effort | 대상은 low/medium/high, 기본 medium, Argon은 minimal도 low으로 매핑 |
extra_body.google.thinking_config | thinking_level, include_thoughts 같은 Gemini 추론 설정, reasoning_effort와 동시 불가 |
tool_calls[].extra_content | google.thought_signature과 도구 이력 전체 보존, 이름과 인수만으로는 서명 누락 |
response_format | 공식 JSON 구조화 출력, Gemini Schema 부분집합 적용, 모든 OpenAI 동작 아님. 원본 필드는 Generate Content Reference |
| 긴 출력 이어가기 | Google 공식 Chat 호환 입구는 긴 출력 이어가기 미지원, 원본 Generate Content 또는 Stream Generate Content 사용 |
| 필드 | 차이 설명 |
|---|
| 암시적 캐시 | 기본 자동, Argon/3.8 Flash 최소 입력 접두사 4096 토큰과 일치 필요, 적중 보장 아님 |
cachedContent | Argon 명시 캐시 생성/참조 오류, 3.8 Flash 지원, Google Cloud 3.7 Flash도 지원 |
| Chat 캐시 참조 | Google층은 extra_body.google.cached_content으로 원본 참조, OpenAI prompt_cache_options 아님. Chat으로 바꿔도 Argon 명시 캐시 불가 |
| 캐시 사용량 | 원본 usageMetadata.cachedContentTokenCount 실제 반환값으로 확인, 설정만으로 적중 아님 |
| 필드 | 차이 설명 |
|---|
mediaResolution | 입력 처리 정밀도, 요청/Part 구조 별도, 개별 설정이 전체 덮어쓰기 가능. 출력 이미지 해상도 아님 |
responseModalities | 셋 모두 텍스트만, TEXT 사용. 일반 IMAGE/AUDIO, imageConfig, speechConfig은 이미지/음성 생성에 사용하지 않음 |
MODEL_ID을 전체 ID로 바꾸세요. 둘 다 중간 강도와 명시 예산, 자동 이어가기 없음.
curl 'https://api.agtcloud.ai/v1beta/models/MODEL_ID:generateContent' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"contents": [{"role": "user", "parts": [{"text": "API 시간 초과 진단 방법을 세 가지로 설명하세요"}]}],
"generationConfig": {
"thinkingConfig": {"thinkingLevel": "MEDIUM"},
"maxOutputTokens": 32768
}
}'