간단한 답변
gemini-4-argon 또는 gemini-4-hydrogen와 같은 Gemini 4 모델을 호출할 때 네이티브 응답의 modelVersion가 요청한 모델과 다르면, HTTP 200을 반환했다는 이유만으로 작업을 성공으로 표시하지 말고, 즉시 자동으로 재시도하지도 마십시오.
응답을 보관하고 요청한 모델, 반환된 모델, responseId 및 비즈니스 작업 ID를 기록하십시오. 작업을 needs_rerun으로 표시하십시오. 배치가 완료된 후 예외 보고서를 생성하고 해당 작업만 대상으로 두 번째 처리를 실행할지 결정하십시오.
조건 확인 방법
네이티브 GeminigenerateContent 응답에는 최상위 수준에 modelVersion 및 responseId가 모두 포함됩니다.
gemini-4-argon를 위한 것이었다면, 반환된 이 모델은 예상과 다릅니다. 텍스트가 정상적으로 보이고 finishReason가 STOP인 경우에도 비즈니스 계층에서 이를 별도로 표시해야 합니다.
- 비스트리밍: 전체 응답에서
modelVersion을 확인합니다. - 스트리밍: 첫 번째 청크만이 아니라 모든 청크를 검사합니다. 공개 재현 결과에 따르면 동일한
responseId에서도 이전 청크와 최종STOP청크가 서로 다른 모델을 보고할 수 있습니다. - OpenAI 호환 형식: 이 확인을 대신하기 위해 응답의
model필드를 사용하지 마십시오. 일반적으로 요청된 모델 이름을 그대로 반환하기 때문입니다. 제공업체가 반환한 모델을 확인해야 할 때는 네이티브 Gemini 형식을 사용합니다.
권장 워크플로
1
모든 요청에서 모델 확인
고정된 모델 ID에는 엄격한 비교를 사용합니다:
response.model_version == requested_model. 값이 누락된 경우 실제 모델을 확인할 수 없으므로 예외 표시도 필요합니다. 기본적으로 통과로 처리해서는 안 됩니다.2
알림을 생성하고 원래 결과 보존
반환된 텍스트나 사용량을 폐기하지 말고 이상을 기록합니다. 결과는 진단에 도움이 되며, 모델 불일치만으로 즉시 두 번째 과금 대상 요청을 생성해서는 안 됩니다.
3
배치를 중지하지 않고 작업 격리
현재 작업을
needs_rerun로 표시하고 나머지 작업을 계속 진행합니다. 배치 보고서에는 최소한 성공한 작업, 모델 보고 이상, 기타 실패, 두 번째 검토를 기다리는 작업을 요약해야 합니다.4
검토 후 두 번째 단계 실행
영향을 받은 작업 ID만 포함하는 목록을 생성합니다. 두 번째 단계에서도 반환된 모든 모델을 다시 확인하고, 첫 번째 보고서는 변경하지 않으며, 자동 재시도를 무제한으로 수행하지 않습니다.
Python 검증 예제
이 예제는google-genai SDK를 사용합니다. 요청을 한 번만 보내고 결정은 호출하는 배치 프로그램에 맡기며, 자동으로 재시도하지 않습니다.
needs_rerun은 True입니다. 텍스트를 청크별로 계속 조합하고, finishReason 및 사용량은 별도로 확인합니다.
배치 보고서에 기록할 항목
API 키는 절대 기록하지 마십시오. 지원팀에 문의할 때는 요청한 모델, 반환된 모델,
responseId, 시간대가 포함된 타임스탬프 및 민감 정보가 제거된 재현 요청을 제공하십시오. 고객 콘텐츠 또는 전체 비즈니스 데이터 세트를 공유하지 마십시오.자주 묻는 질문
불일치를 감지한 후 즉시 재시도하지 않는 이유는 무엇입니까?
불일치를 감지한 후 즉시 재시도하지 않는 이유는 무엇입니까?
즉시 재시도하면 트래픽과 비용이 증가하고, 이상 상태가 지속되는 동안 재시도 폭주가 발생할 수 있습니다. 첫 번째 패스의 증거를 보존하고 제한된 두 번째 패스를 수행하기 전에 영향을 받은 작업을 격리하면 진단과 정산이 더 쉬워집니다. 비즈니스상 자동 재시도가 필요한 경우 최대 시도 횟수, 백오프 및 서킷 브레이커를 설정하고 모든 응답을 기록하십시오.
불일치하는 값이 Flash-Lite가 답변을 생성했다는 것을 입증합니까?
불일치하는 값이 Flash-Lite가 답변을 생성했다는 것을 입증합니까?
이 필드만으로는 어떠한 결론도 내릴 수 없습니다. 실제 라우팅 변경 또는 버전이나 미터링 메타데이터의 이상이 원인일 수 있습니다. 어느 경우든 특정 모델이 반드시 필요한 작업에서는 결과를 모델 일관성 검증 실패로 처리해야 합니다.
모든 모델 이름을 엄격하게 비교해야 합니까?
모든 모델 이름을 엄격하게 비교해야 합니까?
여기서 다루는 고정 Gemini 4 모델 ID에는 완전 일치가 가장 명확한 규칙입니다.
latest와 같은 별칭을 의도적으로 사용하는 경우 구체적인 버전이 반환되는 것은 정상일 수 있습니다. 고정 ID 규칙을 적용하는 대신 명시적으로 허용한 버전 집합을 기준으로 검증하십시오.두 번째 패스에서도 다른 모델이 반환되면 어떻게 합니까?
두 번째 패스에서도 다른 모델이 반환되면 어떻게 합니까?
추가 자동 재시도를 중지하고 두 보고서를 모두 보존하십시오. 영향을 받은
responseId 값, 요청한 모델과 반환된 모델, 타임스탬프 및 정제된 재현 요청을 수집한 다음 APIYI 지원팀에 문의하여 공급자 측 상태를 조사하십시오.관련 문서
Gemini 네이티브 응답 파싱
비스트리밍, 스트리밍, modelVersion, responseId 및 사용량 필드
Gemini 네이티브 API 가이드
google-genai SDK, 네이티브 엔드포인트 및 추론 구성
Gemini 4 Carbon 모델 전환 참고 사항
이전에 관찰된 동작, 영향 및 권장 사항
Gemini 4 Argon 텍스트 생성
Argon의 모델 ID, 이중 엔드포인트 및 호출 예시