All methods

Gemini API

تتيح واجهة برمجة التطبيقات Gemini API للمطوّرين إنشاء تطبيقات ذكاء اصطناعي توليدي باستخدام نماذج Gemini. ‫Gemini هو نموذجنا الأكثر تطورًا، وقد تم تصميمه من البداية ليكون متعدّد الوسائط. يمكنه تعميم وفهم أنواع مختلفة من المعلومات والتعامل معها ودمجها بسلاسة، بما في ذلك اللغة والصور والمحتوى الصوتي والفيديوهات والرموز البرمجية. يمكنك استخدام Gemini API لحالات استخدام مثل الاستدلال على النصوص والصور، وإنشاء المحتوى، ووكلاء الحوار، وأنظمة التلخيص والتصنيف، وغير ذلك.

الخدمة: generativelanguage.googleapis.com

لطلب هذه الخدمة، ننصح باستخدام مكتبات العميل التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لطلب هذه الخدمة، استخدِم المعلومات التالية عند طلب بيانات من واجهة برمجة التطبيقات.

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي الجزء الأساسي من عنوان URL الذي يحدّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد يكون للخدمة الواحدة أكثر من نقطة نهاية واحدة. تحتوي هذه الخدمة على نقطة النهاية التالية، وجميع عناوين URI أدناه تكون نسبيّة لهذه النقطة:

  • https://generativelanguage.googleapis.com

مورد REST: ‏ v1beta.auth_tokens

الطُرق
create POST /v1beta/auth_tokens
ينشئ رمزًا مميزًا يمكن استخدامه لتقييد سلوك جلسة BidiGenerateContent.

مورد REST: ‏ v1beta.batches

الطُرق
cancel POST /v1beta/{name=batches/*}:cancel
تبدأ هذه الطريقة عملية إلغاء غير متزامنة لعملية طويلة الأمد.
delete DELETE /v1beta/{name=batches/*}
تحذف هذه الطريقة عملية طويلة الأمد.
get ‫GET /v1beta/{name=batches/*}
تتيح هذه الطريقة الاطّلاع على أحدث حالة لعملية طويلة.
list GET /v1beta/{name=batches}
تدرِج هذه السمة العمليات التي تتطابق مع الفلتر المحدّد في الطلب.
updateEmbedContentBatch PATCH /v1beta/{embedContentBatch.name=batches/*}:updateEmbedContentBatch
تعدّل هذه الطريقة مجموعة من طلبات EmbedContent للمعالجة على دفعات.
updateGenerateContentBatch PATCH /v1beta/{generateContentBatch.name=batches/*}:updateGenerateContentBatch
تعدّل هذه الطريقة مجموعة من طلبات GenerateContent للمعالجة على دفعات.

مورد REST: ‏ v1beta.cachedContents

الطُرق
create POST /v1beta/cachedContents
ينشئ مورد CachedContent.
delete DELETE /v1beta/{name=cachedContents/*}
يحذف مورد CachedContent.
get GET /v1beta/{name=cachedContents/*}
تقرأ هذه السمة مورد CachedContent.
list GET /v1beta/cachedContents
تعرض هذه السمة قوائم CachedContents.
patch PATCH /v1beta/{cachedContent.name=cachedContents/*}
تعدّل هذه الطريقة مورد CachedContent (يمكن تعديل تاريخ انتهاء الصلاحية فقط).

مورد REST: ‏ v1beta.fileSearchStores

الطُرق
create POST /v1beta/fileSearchStores
تُنشئ FileSearchStore فارغًا.
delete DELETE /v1beta/{name=fileSearchStores/*}
لحذف FileSearchStore
get GET /v1beta/{name=fileSearchStores/*}
تعرض هذه السمة معلومات حول FileSearchStore معيّن.
importFile POST /v1beta/{fileSearchStoreName=fileSearchStores/*}:importFile
يستورد هذا الأمر File من "خدمة الملفات" إلى FileSearchStore.
list GET /v1beta/fileSearchStores
تعرض هذه السمة جميع FileSearchStores التي يملكها المستخدم.

مورد REST: ‏ v1beta.fileSearchStores.documents

الطُرق
delete DELETE /v1beta/{name=fileSearchStores/*/documents/*}
لحذف Document
get GET /v1beta/{name=fileSearchStores/*/documents/*}
تعرض هذه السمة معلومات حول Document معيّن.
list GET /v1beta/{parent=fileSearchStores/*}/documents
تعرض هذه السمة جميع Document في Corpus.

مورد REST: ‏ v1beta.fileSearchStores.operations

الطُرق
get ‫GET /v1beta/{name=fileSearchStores/*/operations/*}
تتيح هذه الطريقة الاطّلاع على أحدث حالة لعملية طويلة.

مورد REST: ‏ v1beta.fileSearchStores.upload.operations

الطُرق
get ‫GET /v1beta/{name=fileSearchStores/*/upload/operations/*}
تتيح هذه الطريقة الاطّلاع على أحدث حالة لعملية طويلة.

مورد REST: ‏ v1beta.files

الطُرق
delete DELETE /v1beta/{name=files/*}
لحذف File
get GET /v1beta/{name=files/*}
تعرض هذه الطريقة البيانات الوصفية الخاصة بـ File المحدّد.
list GET /v1beta/files
تعرض هذه السمة البيانات الوصفية الخاصة بـ File التي يملكها المشروع الذي يرسل الطلب.
register POST /v1beta/files:register
تسجّل هذه السمة ملفات Google Cloud Storage في FileService.

مورد REST: ‏ v1beta.media

الطُرق
download GET /v1beta/{parent=environments/*}/files
يسترد هذا الأمر البيانات الوصفية للملفات أو محتوى الدليل من لقطة للبيئة.
upload POST /v1beta/files
POST /upload/v1beta/files
تنشئ File.
uploadToFileSearchStore POST /v1beta/{fileSearchStoreName=fileSearchStores/*}:uploadToFileSearchStore
POST /upload/v1beta/{fileSearchStoreName=fileSearchStores/*}:uploadToFileSearchStore
تحميل البيانات إلى FileSearchStore، ومعالجتها مسبقًا وتقسيمها إلى أجزاء قبل تخزينها في مستند FileSearchStore

مورد REST: ‏ v1beta.models

الطُرق
asyncBatchEmbedContent POST /v1beta/{batch.model=models/*}:asyncBatchEmbedContent
تضيف هذه الطريقة مجموعة من طلبات EmbedContent إلى قائمة الانتظار لمعالجتها على دفعات.
batchEmbedContents POST /v1beta/{model=models/*}:batchEmbedContents
تنشئ هذه الدالة متجهات تضمين متعددة من الإدخال Content الذي يتألف من مجموعة من السلاسل الممثَّلة كعناصر EmbedContentRequest.
batchGenerateContent POST /v1beta/{batch.model=models/*}:batchGenerateContent
تضيف هذه الطريقة مجموعة من طلبات GenerateContent إلى قائمة الانتظار لمعالجتها على دفعات.
countTokens POST /v1beta/{model=models/*}:countTokens
تنفّذ هذه الدالة أداة الترميز الخاصة بنموذج على الإدخال Content وتعرض عدد الرموز المميزة.
embedContent POST /v1beta/{model=models/*}:embedContent
تنشئ هذه الدالة متّجه تضمين نصي من الإدخال Content باستخدام نموذج Gemini Embedding المحدّد.
generateContent POST /v1beta/{model=models/*}:generateContent
ينشئ ردًا من النموذج بناءً على إدخال GenerateContentRequest.
get GET /v1beta/{name=models/*}
للحصول على معلومات حول Model معيّن، مثل رقم الإصدار وحدود الرموز المميزة والمَعلمات والبيانات الوصفية الأخرى
list GET /v1beta/models
تعرض هذه الطريقة Models المتاحة من خلال Gemini API.
predict POST /v1beta/{model=models/*}:predict
تُستخدَم لإجراء طلب توقّع.
predictLongRunning POST /v1beta/{model=models/*}:predictLongRunning
تعمل هذه الطريقة مثل طريقة Predict، ولكنها تعرض عملية طويلة الأمد.
streamGenerateContent POST /v1beta/{model=models/*}:streamGenerateContent
ينشئ ردًا متسلسلاً من النموذج بناءً على الإدخال GenerateContentRequest.

مورد REST: ‏ v1beta.interactions

الطُرق
CreateCredential POST /v1beta/credentials
تنشئ هذه السمة بيانات اعتماد.
CreateInteraction POST /v1beta/interactions
تُنشئ هذه السمة تفاعلاً جديدًا.
cancelInteractionById POST /v1beta/interactions/{id}/cancel
يلغي هذا الإجراء تفاعلاً حسب المعرّف.
ListCredentials GET /v1beta/credentials
تعرض هذه السمة بيانات اعتماد مشروع.
GetCredential GET /v1beta/credentials/{id}
تعرض هذه الطريقة البيانات الوصفية لبيانات اعتماد واحدة (بدون حقول سرية).
getInteractionById GET /v1beta/interactions/{id}
يستردّ هذا الطلب التفاصيل الكاملة لتفاعل واحد استنادًا إلى `Interaction.id`.
UpdateCredential PATCH /v1beta/credentials/{id}
تعدّل بيانات اعتماد.
DeleteCredential DELETE /v1beta/credentials/{id}
لحذف بيانات اعتماد.
deleteInteraction DELETE /v1beta/interactions/{id}
يحذف هذا الأمر التفاعل حسب رقم التعريف.

مورد REST: ‏ v1beta.agents

الطُرق
CreateAgent POST /v1beta/agents
تنشئ هذه السمة وكيلًا جديدًا (إصدارًا مكتوبًا لحزمة SDK).
ListAgents GET /v1beta/agents
تعرض هذه السمة قائمة بجميع الوكلاء.
GetAgent GET /v1beta/agents/{id}
تعرض هذه الطريقة معلومات عن وكيل محدّد.
DeleteAgent DELETE /v1beta/agents/{id}
لحذف وكيل

مورد REST: ‏ v1beta.webhooks

الطُرق
CreateWebhook POST /v1beta/webhooks
تنشئ هذه الطريقة ويب هوك جديدًا.
PingWebhook POST /v1beta/webhooks/{id}:ping
يرسل حدث إشارة إلى Webhook.
RotateSigningSecret POST /v1beta/webhooks/{id}:rotateSigningSecret
تنشئ هذه الطريقة سر توقيع جديدًا لـ Webhook.
ListWebhooks GET /v1beta/webhooks
تعرض هذه السمة قائمة بجميع الويب هوك.
GetWebhook GET /v1beta/webhooks/{id}
تعرض هذه الطريقة ويب هوك محدّدًا.
UpdateWebhook PATCH /v1beta/webhooks/{id}
تعديل Webhook حالي
DeleteWebhook DELETE /v1beta/webhooks/{id}
يحذف هذا الإجراء ويب هوك.

مورد REST: ‏ v1beta.triggers

الطُرق
CreateTrigger POST /v1beta/triggers
تنشئ هذه السمة مشغّلاً جديدًا يستدعي الوكيل المحدّد وفقًا لجدول cron الزمني المحدّد.
RunTrigger POST /v1beta/triggers/{trigger_id}/executions
يتم تشغيل مشغّل على الفور.
ListTriggers GET /v1beta/triggers
تعرض هذه الطريقة مشغّلات مشروع.
GetTrigger GET /v1beta/triggers/{id}
تعرض هذه الطريقة تفاصيل حول مشغّل واحد.
ListTriggerExecutions GET /v1beta/triggers/{trigger_id}/executions
تعرض هذه الطريقة عمليات التنفيذ الخاصة بمشغّل.
UpdateTrigger PATCH /v1beta/triggers/{id}
تعدّل هذه الطريقة عامل تشغيل.
DeleteTrigger DELETE /v1beta/triggers/{id}
لحذف مشغّل.

مورد REST: ‏ v1beta.environments

الطُرق
CreateEnvironment POST /v1beta/environments
تنشئ هذه السمة بيئة.
ListEnvironments GET /v1beta/environments
تعرض هذه الطريقة البيئات.
GetEnvironmentFiles GET /v1beta/environments/{environment}/files/{path}
يسترد هذا الإجراء البيانات الوصفية للملفات أو محتوى الدليل من لقطة للبيئة.
GetEnvironment GET /v1beta/environments/{id}
تعرض هذه الطريقة بيئة.
StartEnvironmentFileUpload PUT /upload/v1beta/environments/{environment}/files/{path}
يبدأ جلسة تحميل قابلة للاستئناف لملف في مساحة عمل بيئة.
DeleteEnvironment DELETE /v1beta/environments/{id}
لحذف بيئة.