All methods

Generative Language API

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

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

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

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

نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تحتوي خدمة واحدة على نقاط نهاية خدمة متعددة. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط كل معرّفات الموارد المنتظمة (URI) أدناه بنقطة نهاية الخدمة هذه:

  • https://generativelanguage.googleapis.com

مورد 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.corpora

الطُرق
create POST /v1beta/corpora
لإنشاء Corpus فارغ.
delete DELETE /v1beta/{name=corpora/*}
لحذف Corpus.
get GET /v1beta/{name=corpora/*}
للحصول على معلومات عن Corpus معيّن.
list GET /v1beta/corpora
تعرض هذه السمة كل Corpora التي يملكها المستخدم.
patch PATCH /v1beta/{corpus.name=corpora/*}
تعديلات على Corpus
query POST /v1beta/{name=corpora/*}:query
تُجري هذه الوظيفة بحثًا دلاليًا على Corpus.

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

الطُرق
create POST /v1beta/{parent=corpora/*}/documents
لإنشاء Document فارغ.
delete DELETE /v1beta/{name=corpora/*/documents/*}
لحذف Document.
get GET /v1beta/{name=corpora/*/documents/*}
للحصول على معلومات عن Document معيّن.
list GET /v1beta/{parent=corpora/*}/documents
تعرض هذه السمة جميع Document في Corpus.
patch PATCH /v1beta/{document.name=corpora/*/documents/*}
تعديلات على Document
query POST /v1beta/{name=corpora/*/documents/*}:query
تُجري هذه الوظيفة بحثًا دلاليًا على Document.

مورد REST: ‏ v1beta.corpora.documents.chunks

الطُرق
batchCreate POST /v1beta/{parent=corpora/*/documents/*}/chunks:batchCreate
يمكنك إنشاء Chunk في حِزم.
batchDelete POST /v1beta/{parent=corpora/*/documents/*}/chunks:batchDelete
يمكنك حذف Chunk بشكل مجمّع.
batchUpdate POST /v1beta/{parent=corpora/*/documents/*}/chunks:batchUpdate
يمكنك إجراء تعديلات مجمّعة على Chunk.
create POST /v1beta/{parent=corpora/*/documents/*}/chunks
لإنشاء Chunk.
delete DELETE /v1beta/{name=corpora/*/documents/*/chunks/*}
لحذف Chunk.
get GET /v1beta/{name=corpora/*/documents/*/chunks/*}
للحصول على معلومات عن Chunk معيّن.
list GET /v1beta/{parent=corpora/*/documents/*}/chunks
تعرض هذه السمة جميع Chunk في Document.
patch PATCH /v1beta/{chunk.name=corpora/*/documents/*/chunks/*}
تعديلات على Chunk

مورد REST: ‏ v1beta.corpora.permissions

الطُرق
create POST /v1beta/{parent=corpora/*}/permissions
أنشئ إذنًا لمورد معيّن.
delete DELETE /v1beta/{name=corpora/*/permissions/*}
يؤدي هذا الإجراء إلى حذف الإذن.
get GET /v1beta/{name=corpora/*/permissions/*}
للحصول على معلومات عن إذن معيّن.
list GET /v1beta/{parent=corpora/*}/permissions
يسرد الأذونات للمورد المحدّد.
patch PATCH /v1beta/{permission.name=corpora/*/permissions/*}
تعديل الإذن

مورد REST: ‏ v1beta.files

الطُرق
delete DELETE /v1beta/{name=files/*}
يؤدي ذلك إلى حذف File.
get GET /v1beta/{name=files/*}
للحصول على البيانات الوصفية لـ File المحدّد
list GET /v1beta/files
تعرض هذه السمة البيانات الوصفية لـ File التي يملكها المشروع الذي يطلب الحصول على البيانات.

مورد REST: ‏ v1beta.media

الطُرق
upload POST /v1beta/files
POST /upload/v1beta/files
لإنشاء File.

مورد REST: ‏ v1beta.models

الطُرق
batchEmbedContents POST /v1beta/{model=models/*}:batchEmbedContents
تُنشئ هذه الدالة ناقلات إدراج متعددة من الإدخال Content الذي يتألف من مجموعة من السلاسل التي يتم تمثيلها كعناصر EmbedContentRequest.
batchEmbedText POST /v1beta/{model=models/*}:batchEmbedText
تُنشئ هذه الدالة عدّة إدخالات من النموذج المقدَّم في طلب الإدخال في مكالمة متزامنة.
countMessageTokens POST /v1beta/{model=models/*}:countMessageTokens
يشِّط هذا الدالة رمزًا في سلسلة نصية ويعرض عدد الرموز.
countTextTokens POST /v1beta/{model=models/*}:countTextTokens
تُشغِّل هذه الدالة أداة تقسيم النصوص في النموذج على نص معيّن وتُعرِض عدد الرموز.
countTokens POST /v1beta/{model=models/*}:countTokens
يُشغِّل هذا الإجراء أداة تقسيم النصوص في النموذج على الإدخال Content ويعرض عدد الرموز.
embedContent POST /v1beta/{model=models/*}:embedContent
تُنشئ هذه الدالة متجهًا لتمثيل النص من الإدخال Content باستخدام نموذج تمثيل Gemini المحدّد.
embedText POST /v1beta/{model=models/*}:embedText
تُنشئ هذه الدالة تمثيلاً مضمّنًا من النموذج استنادًا إلى رسالة الإدخال.
generateAnswer POST /v1beta/{model=models/*}:generateAnswer
تُنشئ هذه الوظيفة إجابة مستندة إلى النموذج استنادًا إلى إدخال GenerateAnswerRequest.
generateContent POST /v1beta/{model=models/*}:generateContent
تُنشئ هذه الدالة نموذجًا للردّ استنادًا إلى مدخل GenerateContentRequest.
generateMessage POST /v1beta/{model=models/*}:generateMessage
تُنشئ هذه الدالة ردًا من النموذج استنادًا إلى إدخال MessagePrompt.
generateText POST /v1beta/{model=models/*}:generateText
تُنشئ هذه الدالة ردًا من النموذج استنادًا إلى رسالة الإدخال.
get GET /v1beta/{name=models/*}
تحصل هذه الوظيفة على معلومات عن Model محدّد، مثل رقم الإصدار والحدود القصوى للرموز المميّزة والمَعلمات والبيانات الوصفية الأخرى.
list GET /v1beta/models
تعرض هذه السمة Model المتاحة من خلال Gemini API.
streamGenerateContent POST /v1beta/{model=models/*}:streamGenerateContent
تُنشئ هذه الوظيفة ردًا يتم بثه من النموذج استنادًا إلى إدخال GenerateContentRequest.

مورد REST: ‏ v1beta.tunedModels

الطُرق
create POST /v1beta/tunedModels
يؤدي هذا الخيار إلى إنشاء نموذج معدَّل.
delete DELETE /v1beta/{name=tunedModels/*}
يؤدي هذا الإجراء إلى حذف نموذج معدَّل.
generateContent POST /v1beta/{model=tunedModels/*}:generateContent
تُنشئ هذه الدالة نموذجًا للردّ استنادًا إلى مدخل GenerateContentRequest.
generateText POST /v1beta/{model=tunedModels/*}:generateText
تُنشئ هذه الدالة ردًا من النموذج استنادًا إلى رسالة الإدخال.
get GET /v1beta/{name=tunedModels/*}
للحصول على معلومات عن نموذج TunedModel معيّن
list GET /v1beta/tunedModels
تعرض هذه القائمة النماذج المحسّنة التي تم إنشاؤها.
patch PATCH /v1beta/{tunedModel.name=tunedModels/*}
لتعديل نموذج معدَّل
streamGenerateContent POST /v1beta/{model=tunedModels/*}:streamGenerateContent
تُنشئ هذه الوظيفة ردًا يتم بثه من النموذج استنادًا إلى إدخال GenerateContentRequest.
transferOwnership POST /v1beta/{name=tunedModels/*}:transferOwnership
يؤدي هذا الإجراء إلى نقل ملكية النموذج المحسَّن.

مورد REST: ‏ v1beta.tunedModels.permissions

الطُرق
create POST /v1beta/{parent=tunedModels/*}/permissions
أنشئ إذنًا لمورد معيّن.
delete DELETE /v1beta/{name=tunedModels/*/permissions/*}
يؤدي هذا الإجراء إلى حذف الإذن.
get GET /v1beta/{name=tunedModels/*/permissions/*}
للحصول على معلومات عن إذن معيّن.
list GET /v1beta/{parent=tunedModels/*}/permissions
يسرد الأذونات للمورد المحدّد.
patch PATCH /v1beta/{permission.name=tunedModels/*/permissions/*}
تعديل الإذن