안전 설정

Gemini API는 프로토타입 제작 단계에서 조정하여 애플리케이션에 더 제한적인 안전 구성이 필요한지 아니면 덜 제한적인 안전 구성이 필요한지 판단할 수 있는 안전 설정을 제공합니다. 4가지 필터 카테고리에서 이러한 설정을 조정하여 특정 유형의 콘텐츠를 제한하거나 허용할 수 있습니다.

이 가이드에서는 Gemini API가 안전 설정 및 필터링을 처리하는 방법과 애플리케이션의 안전 설정을 변경하는 방법을 설명합니다.

안전 필터

Gemini API의 조정 가능한 안전 필터는 다음 카테고리를 다룹니다.

카테고리 설명
괴롭힘 ID 또는 보호 속성을 대상으로 하는 부정적이거나 유해한 댓글
증오심 표현 무례하거나 모욕적이거나 욕설이 있는 콘텐츠
음란물 성행위 또는 기타 외설적인 콘텐츠에 대한 참조가 포함
위험 유해한 행위를 조장, 촉진 또는 장려합니다.
시민적 성실성 선거 관련 검색어

이러한 필터를 사용하여 사용 사례에 적합한 사항을 조정할 수 있습니다. 예를 들어 동영상 게임 대화를 제작하는 경우 게임의 특성상 위험으로 평가되는 콘텐츠를 더 많이 허용해도 괜찮다고 판단할 수 있습니다.

조정 가능한 안전 필터 외에도 Gemini API에는 아동 안전을 저해하는 콘텐츠와 같은 핵심 유해 요소에 대한 기본 제공 보호 조치가 있습니다. 이러한 유형의 피해는 항상 차단되며 조정할 수 없습니다.

콘텐츠 안전 필터링 수준

Gemini API는 콘텐츠가 안전하지 않을 가능성 수준을 HIGH, MEDIUM, LOW, NEGLIGIBLE로 분류합니다.

Gemini API는 콘텐츠의 심각도가 아닌 안전하지 않을 가능성을 기준으로 콘텐츠를 차단합니다. 일부 콘텐츠는 심각도의 유해성이 높더라도 안전하지 않을 가능성이 낮을 수 있으므로 이를 고려하는 것이 중요합니다. 예를 들어 다음 문장을 비교해 보겠습니다.

  1. 로봇이 나를 때렸습니다.
  2. 로봇이 나를 베었습니다.

첫 번째 문장은 안전하지 않을 가능성이 더 높을 수 있지만 폭력 측면에서는 두 번째 문장이 더 심각하다고 생각할 수 있습니다. 따라서 최종 사용자에게 해를 주지 않으면서 주요 사용 사례를 지원하는 데 필요한 적절한 수준의 차단이 무엇인지 신중하게 고려하고 테스트해야 합니다.

요청당 안전 필터링

API에 대한 각 요청에 대해 안전 설정을 조정할 수 있습니다. 요청하면 콘텐츠가 분석되고 안전 등급이 지정됩니다. 안전 평점에는 피해 분류의 카테고리와 확률이 포함됩니다. 예를 들어 괴롭힘 카테고리의 확률이 높아 콘텐츠가 차단된 경우 반환된 안전 등급의 카테고리는 HARASSMENT이고 피해 확률은 HIGH로 설정됩니다.

기본적으로 안전 설정은 모든 필터에서 안전하지 않을 가능성이 중간 이상인 경우 프롬프트를 포함한 콘텐츠를 차단합니다. 이 기준 안전은 대부분의 사용 사례에 적합하게 설계되었으므로 안전 설정을 조정하려면 애플리케이션에 지속적으로 필요한 경우에만 그렇게 해야 합니다.

다음 표에서는 각 카테고리에 대해 조정할 수 있는 차단 설정을 확인할 수 있습니다. 예를 들어 증오심 표현 카테고리에 대해 차단 설정을 소수 차단으로 설정하면 증오심 표현 콘텐츠일 가능성이 높은 모든 항목이 차단됩니다. 하지만 가능성이 낮은 모든 항목이 허용됩니다.

기준 (Google AI Studio) 기준(API) 설명
차단 안 함 BLOCK_NONE 콘텐츠의 안전하지 않은 가능성에 관계없이 항상 표시
소수 차단 BLOCK_ONLY_HIGH 안전하지 않은 콘텐츠일 가능성이 높은 경우 차단
일부 차단 BLOCK_MEDIUM_AND_ABOVE 안전하지 않은 콘텐츠일 가능성이 중간 또는 높은 경우 차단
대부분 차단 BLOCK_LOW_AND_ABOVE 안전하지 않은 콘텐츠일 가능성이 낮음, 중간 또는 높음인 경우 차단
해당 사항 없음 HARM_BLOCK_THRESHOLD_UNSPECIFIED 기준점이 지정되지 않았습니다. 기본 기준점을 사용하여 차단합니다.

기준점이 설정되지 않은 경우 기본 차단 기준점은 시민적 성실성 카테고리를 제외한 모든 카테고리의 경우 대부분 차단 (gemini-1.5-pro-002gemini-1.5-flash-002만 해당) 또는 일부 차단 (기타 모든 모델)입니다.

시민적 성실성 카테고리의 기본 차단 기준점은 Google AI Studio를 사용하여 프롬프트를 보낼 때는 대부분 차단이고 Gemini API를 직접 사용할 때는 전체 차단입니다.

생성형 서비스에 대한 각 요청에 이러한 설정을 지정할 수 있습니다. 자세한 내용은 HarmBlockThreshold API 참조를 확인하세요.

안전 관련 의견

generateContent는 안전 의견이 포함된 GenerateContentResponse를 반환합니다.

프롬프트 의견은 promptFeedback에 포함되어 있습니다. promptFeedback.blockReason가 설정된 경우 프롬프트의 콘텐츠가 차단되었습니다.

응답 후보 의견은 Candidate.finishReasonCandidate.safetyRatings에 포함됩니다. 응답 콘텐츠가 차단되고 finishReasonSAFETY인 경우 safetyRatings를 검사하여 자세한 내용을 확인할 수 있습니다. 차단된 콘텐츠는 반환되지 않습니다.

안전 설정 조정

이 섹션에서는 Google AI 스튜디오와 코드에서 모두 안전 설정을 조정하는 방법을 설명합니다.

Google AI Studio

Google AI 스튜디오에서 안전 설정을 조정할 수 있지만 사용 중지할 수는 없습니다.

실행 설정 패널에서 안전 설정 수정을 클릭하여 안전 설정 실행 모달을 엽니다. 모달에서 슬라이더를 사용하여 안전 카테고리별 콘텐츠 필터링 수준을 조정할 수 있습니다.

요청을 전송하면 (예: 모델에게 질문) 요청 콘텐츠가 차단된 경우 콘텐츠 없음 메시지가 표시됩니다. 자세한 내용을 보려면 콘텐츠 없음 텍스트 위로 포인터를 가져간 다음 안전을 클릭합니다.

Gemini API SDK

다음 코드 스니펫은 GenerateContent 호출에서 안전 설정을 설정하는 방법을 보여줍니다. 이렇게 하면 괴롭힘(HARM_CATEGORY_HARASSMENT) 및 증오심 표현 (HARM_CATEGORY_HATE_SPEECH) 카테고리의 기준점이 설정됩니다. 예를 들어 이러한 카테고리를 BLOCK_LOW_AND_ABOVE로 설정하면 괴롭힘 또는 증오심 표현일 가능성이 낮거나 높은 모든 콘텐츠가 차단됩니다. 기준점 설정을 알아보려면 요청당 안전 필터링을 참고하세요.

Python

from google.generativeai.types import HarmCategory, HarmBlockThreshold

model = genai.GenerativeModel(model_name='gemini-1.5-flash')
response = model.generate_content(
    ['Do these look store-bought or homemade?', img],
    safety_settings={
        HarmCategory.HARM_CATEGORY_HATE_SPEECH: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
        HarmCategory.HARM_CATEGORY_HARASSMENT: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
    }
)

Go

model := client.GenerativeModel("gemini-1.5-flash")

model.SafetySettings = []*genai.SafetySetting{
  {
    Category:  genai.HarmCategoryHarassment,
    Threshold: genai.HarmBlockLowAndAbove,
  },
  {
    Category:  genai.HarmCategoryHateSpeech,
    Threshold: genai.HarmBlockLowAndAbove,
  },
}

Node.js

import { HarmBlockThreshold, HarmCategory } from "@google/generative-ai";

// ...

const safetySettings = [
  {
    category: HarmCategory.HARM_CATEGORY_HARASSMENT,
    threshold: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
  },
  {
    category: HarmCategory.HARM_CATEGORY_HATE_SPEECH,
    threshold: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
  },
];

const model = genAi.getGenerativeModel({ model: "gemini-1.5-flash", safetySettings: safetySettings });

import { HarmBlockThreshold, HarmCategory } from "@google/generative-ai";

// ...

const safetySettings = [
  {
    category: HarmCategory.HARM_CATEGORY_HARASSMENT,
    threshold: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
  },
  {
    category: HarmCategory.HARM_CATEGORY_HATE_SPEECH,
    threshold: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
  },
];

const model = genAi.getGenerativeModel({ model: "gemini-1.5-flash", safetySettings });

Dart (Flutter)

final safetySettings = [
  SafetySetting(HarmCategory.harassment, HarmBlockThreshold.low),
  SafetySetting(HarmCategory.hateSpeech, HarmBlockThreshold.low),
];
final model = GenerativeModel(
  model: 'gemini-1.5-flash',
  apiKey: apiKey,
  safetySettings: safetySettings,
);

Kotlin

val harassmentSafety = SafetySetting(HarmCategory.HARASSMENT, BlockThreshold.LOW_AND_ABOVE)

val hateSpeechSafety = SafetySetting(HarmCategory.HATE_SPEECH, BlockThreshold.LOW_AND_ABOVE)

val generativeModel = GenerativeModel(
    modelName = "gemini-1.5-flash",
    apiKey = BuildConfig.apiKey,
    safetySettings = listOf(harassmentSafety, hateSpeechSafety)
)

자바

SafetySetting harassmentSafety = new SafetySetting(HarmCategory.HARASSMENT,
    BlockThreshold.LOW_AND_ABOVE);

SafetySetting hateSpeechSafety = new SafetySetting(HarmCategory.HATE_SPEECH,
    BlockThreshold.LOW_AND_ABOVE);

GenerativeModel gm = new GenerativeModel(
    "gemini-1.5-flash",
    BuildConfig.apiKey,
    null, // generation config is optional
    Arrays.asList(harassmentSafety, hateSpeechSafety)
);

GenerativeModelFutures model = GenerativeModelFutures.from(gm);

REST

    echo '{
    "safetySettings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "threshold": "BLOCK_ONLY_HIGH"},
        {"category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "BLOCK_MEDIUM_AND_ABOVE"}
    ],
    "contents": [{
        "parts":[{
            "text": "'I support Martians Soccer Club and I think Jupiterians Football Club sucks! Write a ironic phrase about them.'"}]}]}' > request.json

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=$GOOGLE_API_KEY" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d @request.json 2> /dev/null

다음 단계

  • 전체 API에 관한 자세한 내용은 API 참조를 참고하세요.
  • LLM으로 개발할 때의 안전 고려사항을 간략히 살펴보려면 안전 가이드를 검토하세요.
  • Jigsaw팀에서 확률과 심각도 평가에 대해 자세히 알아보기
  • Perspective API와 같이 안전 솔루션에 기여하는 제품에 대해 자세히 알아보세요. * 이러한 안전 설정을 사용하여 독성 분류기를 만들 수 있습니다. 시작하려면 분류 예시를 참고하세요.