Python 干货:教你如何利用 SDK 自定义 Gemini 的安全设置项

浅伟姑娘_3727

浅伟姑娘_3727

2026-03-22

474人浏览

原创

需通过sdk显式配置safety_settings参数实现精细安全控制:一、直接传入字典指定类别与阈值;二、用harmcategory和harmblockthreshold枚举提升类型安全;三、在chatsession中持久化策略;四、动态切换多套配置适配不同场景。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

python 干货:教你如何利用 sdk 自定义 gemini 的安全设置项

如果您希望在使用 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 参数并发起请求。

Ask Gemini/ChatGPT
Ask Gemini/ChatGPT

用于在用户想通过浏览器自动化与 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 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1551

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

3704

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1569

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

21197

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2607

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2667

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1083

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

576

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2063

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Gemini Notebook常见问题解答
Gemini Notebook常见问题解答

共0课时 | 0人学习

Gemini Notebook官方手册
Gemini Notebook官方手册

共0课时 | 0人学习