需通过sdk显式配置safety_settings参数实现精细安全控制:一、直接传入字典指定类别与阈值;二、用harmcategory和harmblockthreshold枚举提升类型安全;三、在chatsession中持久化策略;四、动态切换多套配置适配不同场景。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在使用 Gemini SDK 时对模型输出施加更精细的安全控制,例如限制特定类型的内容生成或调整内置安全过滤器的敏感度,则需要通过 SDK 显式配置安全设置项。以下是实现该目标的具体方法:
一、通过 safety_settings 参数传入自定义安全类别与阈值
Gemini SDK 支持在 generate_content 或 chat_session 初始化时传入 safety_settings 字典,每个键对应一个预定义的安全类别,值为指定的阻断级别。此方式直接作用于单次请求,无需修改全局配置。
1、导入 google.generativeai 并配置 API 密钥。
2、调用 genai.GenerativeModel() 初始化模型实例。
3、构造 safety_settings 字典,例如:{"HARM_CATEGORY_HARASSMENT": "BLOCK_ONLY_HIGH", "HARM_CATEGORY_DANGEROUS_CONTENT": "BLOCK_MEDIUM_AND_ABOVE"}。
4、将该字典作为 safety_settings 参数传入 model.generate_content() 方法中。
二、使用 HarmBlockThreshold 和 HarmCategory 枚举精确指定策略
SDK 提供了 HarmCategory 与 HarmBlockThreshold 枚举类,避免硬编码字符串,提升代码可读性与类型安全性。该方式适用于需长期维护或多人协作的项目。
1、从 google.generativeai.types 导入 HarmCategory 和 HarmBlockThreshold。
2、构建字典,键使用 HarmCategory.HARM_CATEGORY_SEXUALLY_EXPLICIT,值使用 HarmBlockThreshold.BLOCK_LOW_AND_ABOVE。
3、确保所用枚举值在当前 SDK 版本中有效,可通过打印 HarmCategory.__members__ 查看全部支持类别。
4、将该字典赋值给 safety_settings 参数并发起请求。
用于在用户想通过浏览器自动化与 Google Gemini 或 ChatGPT 交互时。触发短语包括“ask Gemini”“ask ChatGPT”“ask GPT”“让...”。
三、在 ChatSession 中持久化安全策略
若需在整个对话生命周期内维持统一的安全过滤强度,可在创建 ChatSession 时一次性注入 safety_settings,后续所有 send_message 调用均继承该配置,无需重复传参。
1、调用 model.start_chat() 方法,并传入 safety_settings 参数。
2、确认传入的字典结构与 generate_content 所需格式完全一致。
3、后续调用 chat.send_message() 时,无需再次提供 safety_settings,系统自动沿用初始化时设定的策略。
4、如需临时覆盖,可在 send_message 中额外传入新的 safety_settings 字典,优先级高于会话级设置。
四、动态切换不同安全配置应对多场景需求
针对同一模型实例服务多个用户或多种内容场景(如儿童模式/成人审核模式),可预先定义多套安全配置字典,在运行时根据上下文条件选择加载。
1、定义 child_mode_policy = {HarmCategory.HARM_CATEGORY_UNSPECIFIED: HarmBlockThreshold.BLOCK_ALL}。
2、定义 editor_mode_policy = {HarmCategory.HARM_CATEGORY_HATE_SPEECH: HarmBlockThreshold.BLOCK_NONE}。
3、在业务逻辑分支中判断当前场景,将对应策略字典作为参数传入 generate_content 或 start_chat。
4、确保各策略字典中未显式声明的类别将采用 Gemini 默认行为,不会因部分键缺失而触发异常或重置为全阻断。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










