讲师中心 微信公众号
AI工具推荐 视频效率加速

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

浅伟姑娘_3727

浅伟姑娘_3727

发布时间:2026-03-22 15:18:30

|

474人浏览过

|

来源于php中文网

原创

需通过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() 初始化模型实例。

立即学习Python免费学习笔记(深入)”;

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__ 查看全部支持类别

Ask Gemini/ChatGPT
Ask Gemini/ChatGPT

用于在用户想通过浏览器自动化与 Google Gemini 或 ChatGPT 交互时。触发短语包括“ask Gemini”“ask ChatGPT”“ask GPT”“让...”。

下载

4、将该字典赋值给 safety_settings 参数并发起请求。

三、在 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 默认行为,不会因部分键缺失而触发异常或重置为全阻断

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

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

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

1551

2023.07.20

python能做什么
python能做什么

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

3684

2023.07.25

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

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

1569

2023.07.31

python教程
python教程

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

21037

2023.08.03

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

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

2587

2023.08.04

python eval
python eval

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

2667

2023.08.04

scratch和python区别
scratch和python区别

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

1083

2023.08.11

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

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

576

2023.08.10

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

0

2026.09.22

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn