إعدادات الأمن الشخصي  |  Gemini API  |  Google AI for Developers
التخطّي إلى المحتوى الرئيسي
/
English
Deutsch
Español – América Latina
Français
Indonesia
Italiano
Polski
Português – Brasil
Shqip
Tiếng Việt
Türkçe
Русский
עברית
العربيّة
فارسی
हिंदी
বাংলা
ภาษาไทย
中文 – 简体
中文 – 繁體
日本語
한국어
الحصول على مفتاح واجهة برمجة التطبيقات
كتاب الطبخ
منتدى
تسجيل الدخول
المستندات
مرجع واجهة برمجة التطبيقات
Gemini API
المستندات
مرجع واجهة برمجة التطبيقات
الحصول على مفتاح واجهة برمجة التطبيقات
كتاب الطبخ
منتدى
البدء
نظرة عامة
البدء
مفاتيح واجهة برمجة التطبيقات
المكتبات
الأسعار
واجهة برمجة التطبيقات Interactions API
إعداد وكيل البرمجة
الطرُز
كل الطرز
الحالي: Gemini 3.5
Nano Banana
Veo
Gemini Omni Flash
‫Lyria 3
Lyria RealTime
Imagen
نص إلى كلام
الفيديوهات المباشرة
الترجمة المباشرة
التضمينات
روبوتيات
الإمكانات الأساسية
نص
صورة
إنشاء الصور 🍌
فهم الصور
فيديو
نظرة عامة على الفيديو
فهم الفيديو
المستندات
الكلام والصوت
إنشاء الكلام
فهم الصوت
جارٍ التفكير
جارٍ التفكير
توقيعات الأفكار
النتائج المنظَّمة
استدعاء الدالة
سياق طويل
الوكلاء
نظرة عامة
التشغيل السريع
Antigravity Agent
إنشاء وكلاء مُدارين
البيئات
Deep Research Agent
الأدوات
نظرة عامة
Google Search
Google Maps
تنفيذ الرمز البرمجي
سياق عنوان URL
استخدام الكمبيوتر
البحث عن الملفات
الجمع بين "الأدوات" و"استدعاء الدالة"
واجهة برمجة التطبيقات للبث المباشر
نظرة عامة
البدء
بدء استخدام حزمة تطوير البرامج (SDK) للذكاء الاصطناعي التوليدي
بدء استخدام WebSockets غير المعالجة
الإمكانات
الترجمة المباشرة
استخدام الأداة
إدارة الجلسة
الرموز المميّزة المؤقتة
أفضل الممارسات
التحسين
نظرة عامة
Batch API
الردّ التلقائي على الويب
الاستنتاج المرن
الاستدلال حسب الأولوية
التخزين المؤقت للسياق
الأدلة
بث
التنفيذ في الخلفية
إدخال الملف
أساليب الإدخال
واجهة برمجة تطبيقات الملفات
التوافق مع OpenAI
درجة دقة الوسائط
احتساب الرموز المميّزة
هندسة الطلبات
السجلّات ومجموعات البيانات
بدء استخدام السجلات
تسجيل البيانات ومشاركتها
دفاع
إعدادات الأمن الشخصي
إرشادات السلامة
الأطر
LangChain وLangGraph
CrewAI
LlamaIndex
Vercel AI SDK
زماني
الموارد
ملاحظات حول الإصدار
الميزات التي سيتم إيقافها نهائيًا
النقل
نقل البيانات إلى حزمة تطوير برامج الذكاء الاصطناعي التوليدي
نقل البيانات إلى Interactions API
التغييرات غير المتوافقة في التفاعلات (مايو 2026)
حدود المعدل
معلومات الفوترة
تحديد المشاكل في واجهة برمجة التطبيقات وحلّها
الحالة
عمليات الدمج مع الشركاء والمكتبات
Google AI Studio
التشغيل السريع
البرمجة الوصفية في "وضع الإنشاء"
تطوير تطبيقات الحزمة الكاملة
إنشاء تطبيقات Android
نشر تطبيقك
الوكلاء في مساحة تجربة الذكاء الاصطناعي في Studio
تجربة LearnLM
تحديد المشاكل وحلّها
إمكانية الوصول لمستخدمي Workspace
Google Cloud Platform
Gemini Enterprise Agent Platform Gemini API
مصادقة OAuth
السياسات
بنود الخدمة
المناطق المتاحة
رصد إساءة الاستخدام
الملاحظات في "تعليقات Google"
أصبحت Interactions API متاحة الآن للجميع. ننصحك باستخدام واجهة برمجة التطبيقات هذه للوصول إلى جميع أحدث الميزات والنماذج.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
الصفحة الرئيسية
Gemini API
المستندات
إرسال ملاحظات
إعدادات الأمن الشخصي
توفّر Gemini API إعدادات أمان يمكنك تعديلها خلال مرحلة إنشاء النموذج الأولي لتحديد ما إذا كان تطبيقك يتطلّب إعدادات أمان أكثر أو أقل تقييدًا. يمكنك تعديل هذه الإعدادات في أربع فئات فلاتر لحظر أنواع معيّنة من المحتوى أو السماح بها.
يشرح هذا الدليل كيفية تعامل Gemini API مع إعدادات الأمان والفلترة، وكيف يمكنك تغيير إعدادات الأمان لتطبيقك.
ملاحظة: قد تخضع التطبيقات التي تستخدم إعدادات أمان أقل تقييدًا للمراجعة. لمزيد من المعلومات، يُرجى الاطّلاع على بنود الخدمة.
فلاتر الأمان
تغطّي فلاتر الأمان القابلة للضبط في Gemini API الفئات التالية:
الفئة
الوصف
التحرش
تعليقات سلبية أو ضارة تستهدف الهوية و/أو السمات المحمية
الكلام الذي يحضّ على الكراهية
محتوى وقح أو غير محترم أو بذيء
محتوى جنسي فاضح
محتوى يشير إلى أفعال جنسية أو محتوى فاحش آخر
الفئات الخطيرة
محتوى يروّج لأفعال ضارة أو يسهّلها أو يشجّع عليها
يتم تحديد هذه الفئات في HarmCategory. يمكنك استخدام هذه الفلاتر لتعديل المحتوى المناسب لحالة الاستخدام. على سبيل المثال، إذا كنت تنشئ حوارًا للعبة فيديو، قد تعتبر أنّه من المقبول السماح بمزيد من المحتوى الذي تم تقييمه على أنّه خطير بسبب طبيعة اللعبة.
بالإضافة إلى فلاتر الأمان القابلة للضبط، تتضمّن Gemini API وسائل حماية مضمّنة ضد الأضرار الأساسية، مثل المحتوى الذي يعرّض سلامة الأطفال للخطر.
يتم حظر هذه الأنواع من الأضرار دائمًا ولا يمكن تعديلها.
مستوى فلترة المحتوى من حيث الأمان
تصنّف Gemini API مستوى احتمالية أن يكون المحتوى غير آمن على أنّه HIGH أو MEDIUM أو LOW أو NEGLIGIBLE.
تحظر Gemini API المحتوى استنادًا إلى احتمالية أن يكون المحتوى غير آمن وليس استنادًا إلى مدى خطورته. من المهم أخذ ذلك في الاعتبار لأنّ بعض المحتوى قد يكون لديه احتمالية منخفضة بأن يكون غير آمن على الرغم من أنّ مدى الضرر قد يظل مرتفعًا. على سبيل المثال، عند مقارنة الجملتين:
ضربني الروبوت.
قطعني الروبوت.
قد تؤدي الجملة الأولى إلى احتمالية أعلى بأن تكون غير آمنة، ولكن قد تعتبر الجملة الثانية أكثر خطورة من حيث العنف.
في ضوء ذلك، من المهم إجراء اختبار دقيق وتحديد مستوى الحظر المناسب المطلوب لدعم حالات الاستخدام الرئيسية مع تقليل الضرر الذي يلحق بالمستخدمين النهائيين.
فلترة الأمان لكل طلب
يمكنك تعديل إعدادات الأمان لكل طلب ترسله إلى واجهة برمجة التطبيقات. عند إرسال طلب، يتم تحليل المحتوى وتعيين تقييم أمان له. يتضمّن تقييم الأمان الفئة واحتمالية تصنيف الضرر. على سبيل المثال، إذا تم حظر المحتوى بسبب احتمالية عالية لفئة التحرش، سيكون تقييم الأمان الذي يتم عرضه من الفئة HARASSMENT، وسيتم ضبط احتمالية الضرر على HIGH.
بسبب الأمان المتأصّل في النموذج، تكون الفلاتر الإضافية غير مفعّلة تلقائيًا.
إذا اخترت تفعيلها، يمكنك ضبط النظام لحظر المحتوى استنادًا إلى احتمالية أن يكون غير آمن. يغطّي السلوك التلقائي للنموذج معظم حالات الاستخدام، لذا عليك تعديل هذه الإعدادات فقط إذا كان ذلك مطلوبًا باستمرار لتطبيقك.
يصف الجدول التالي إعدادات الحظر التي يمكنك تعديلها لكل فئة. على سبيل المثال، إذا ضبطت إعداد الحظر على حظر القليل لفئة الكلام الذي يحضّ على الكراهية، يتم حظر كل المحتوى الذي لديه احتمالية عالية بأن يكون كلامًا يحضّ على الكراهية. ولكن يُسمح بأي محتوى لديه احتمالية أقل.
الحدّ (Google AI Studio)
الحدّ (واجهة برمجة التطبيقات)
الوصف
إيقاف
OFF
إيقاف فلتر الأمان
بدون حظر
BLOCK_NONE
العرض دائمًا بغض النظر عن احتمالية أن يكون المحتوى غير آمن
حظر القليل
BLOCK_ONLY_HIGH
الحظر عند وجود احتمالية عالية بأن يكون المحتوى غير آمن
حظر بعض المحتوى
BLOCK_MEDIUM_AND_ABOVE
الحظر عند وجود احتمالية متوسطة أو عالية بأن يكون المحتوى غير آمن
حظر معظم المحتوى
BLOCK_LOW_AND_ABOVE
الحظر عند وجود احتمالية منخفضة أو متوسطة أو عالية بأن يكون المحتوى غير آمن
لا ينطبق
HARM_BLOCK_THRESHOLD_UNSPECIFIED
لم يتم تحديد الحدّ، ويتم الحظر باستخدام الحدّ التلقائي
إذا لم يتم ضبط الحدّ، يكون الحدّ التلقائي للحظر إيقاف لطرازَي Gemini 2.5 و3.
يمكنك ضبط هذه الإعدادات لكل طلب ترسله إلى الخدمة التوليدية.
لمزيد من التفاصيل، يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات HarmBlockThreshold.
ملاحظات الأمان
generateContent
تعرض الدالة
GenerateContentResponse يتضمّن ملاحظات الأمان.
يتم تضمين ملاحظات الطلب في
promptFeedback. إذا تم ضبط promptFeedback.blockReason، يعني ذلك أنّه تم حظر محتوى الطلب.
يتم تضمين ملاحظات المرشّح للردّ في
Candidate.finishReason و
Candidate.safetyRatings. إذا تم حظر محتوى الردّ وكان finishReason هو SAFETY، يمكنك فحص safetyRatings للحصول على مزيد من التفاصيل. لا يتم عرض المحتوى الذي تم حظره.
تعديل إعدادات الأمان
يشرح هذا القسم كيفية تعديل إعدادات الأمان في كل من Google AI Studio وفي الرمز البرمجي.
Google AI Studio
يمكنك تعديل إعدادات الأمان في Google AI Studio.
انقر على إعدادات الأمان ضمن الإعدادات المتقدّمة في لوحة إعدادات التشغيل لفتح النافذة المنبثقة تشغيل إعدادات الأمان. في النافذة المنبثقة، يمكنك استخدام أشرطة التمرير لتعديل مستوى فلترة المحتوى لكل فئة أمان:
ملاحظة: أنت مسؤول عن التأكّد من أنّ إعدادات الأمان لحالة الاستخدام المقصودة تتوافق مع بنود الخدمة.
عند إرسال طلب (على سبيل المثال، من خلال طرح سؤال على النموذج)، تظهر رسالة warning
تم حظر المحتوى إذا تم حظر محتوى الطلب. للاطّلاع على مزيد من التفاصيل، مرِّر المؤشر فوق النص تم حظر المحتوى للاطّلاع على الفئة واحتمالية تصنيف الضرر.
أمثلة للرموز البرمجية
يوضّح مقتطف الرمز البرمجي التالي كيفية ضبط إعدادات الأمان في طلب GenerateContent. يضبط هذا الرمز الحدّ لفئة الكلام الذي يحضّ على الكراهية (HARM_CATEGORY_HATE_SPEECH). يؤدي ضبط هذه الفئة على BLOCK_LOW_AND_ABOVE إلى حظر أي محتوى لديه احتمالية منخفضة أو أعلى بأن يكون كلامًا يحضّ على الكراهية. لفهم إعدادات الحدّ، يُرجى الاطّلاع على فلترة الأمان
لكل طلب.
Python
from google import genai
from google.genai import types
client = genai.Client()
response = client.models.generate_content(
model="gemini-3.5-flash",
contents="Some potentially unsafe prompt",
config=types.GenerateContentConfig(
safety_settings=[
types.SafetySetting(
category=types.HarmCategory.HARM_CATEGORY_HATE_SPEECH,
threshold=types.HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
),
]
)
)
print(response.text)
انتقال
package main
import (
"context"
"fmt"
"log"
"google.golang.org/genai"
)
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, nil)
if err != nil {
log.Fatal(err)
}
config := &genai.GenerateContentConfig{
SafetySettings: []*genai.SafetySetting{
{
Category:  "HARM_CATEGORY_HATE_SPEECH",
Threshold: "BLOCK_LOW_AND_ABOVE",
},
},
}
response, err := client.Models.GenerateContent(
ctx,
"gemini-3.5-flash",
genai.Text("Some potentially unsafe prompt."),
config,
)
if err != nil {
log.Fatal(err)
}
fmt.Println(response.Text())
}
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
const safetySettings = [
{
category: "HARM_CATEGORY_HATE_SPEECH",
threshold: "BLOCK_LOW_AND_ABOVE",
},
];
async function main() {
const response = await ai.models.generateContent({
model: "gemini-3.5-flash",
contents: "Some potentially unsafe prompt.",
config: {
safetySettings: safetySettings,
},
});
console.log(response.text);
}
await main();
جافا
SafetySetting hateSpeechSafety = new SafetySetting(HarmCategory.HATE_SPEECH,
BlockThreshold.LOW_AND_ABOVE);
GenerativeModel gm = new GenerativeModel(
"gemini-3.5-flash",
BuildConfig.apiKey,
null, // generation config is optional
Arrays.asList(hateSpeechSafety)
);
GenerativeModelFutures model = GenerativeModelFutures.from(gm);
REST
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{
"safetySettings": [
{"category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "BLOCK_LOW_AND_ABOVE"}
],
"contents": [{
"parts":[{
"text": "'\''Some potentially unsafe prompt.'\''"
}]
}]
}'
الخطوات التالية
يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات لمعرفة المزيد عن واجهة برمجة التطبيقات الكاملة.
يمكنك مراجعة إرشادات الأمان للحصول على نظرة عامة على اعتبارات الأمان
عند التطوير باستخدام النماذج اللغوية الكبيرة.
يمكنك التعرّف أكثر على تقييم الاحتمالية مقابل مدى الخطورة من فريق Jigsaw
يمكنك التعرّف أكثر على المنتجات التي تساهم في حلول الأمان، مثل الـ
Perspective
API.
*   يمكنك استخدام إعدادات الأمان هذه لإنشاء مصنِّف للمحتوى السام. للبدء، يُرجى الاطّلاع على مثال التصنيف.
إرسال ملاحظات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0‏ ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0‏. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers‏. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2026-06-01 (حسب التوقيت العالمي المتفَّق عليه)
هل تريد مشاركة ملاحظاتك معنا؟
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-06-01 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]
البنود
الخصوصية
Manage cookies
English
Deutsch
Español – América Latina
Français
Indonesia
Italiano
Polski
Português – Brasil
Shqip
Tiếng Việt
Türkçe
Русский
עברית
العربيّة
فارسی
हिंदी
বাংলা
ภาษาไทย
中文 – 简体
中文 – 繁體
日本語
한국어