All methods

Generative Language API

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

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

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

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

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

  • https://generativelanguage.googleapis.com

مورد REST: ‏ v1beta.batches

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

مورد 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
إنشاء Chunks بشكل مجمّع
batchDelete POST /v1beta/{parent=corpora/*/documents/*}/chunks:batchDelete
حذف Chunks بشكل مجمّع
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

الطُرق
asyncBatchEmbedContent POST /v1beta/{batch.model=models/*}:asyncBatchEmbedContent
تضيف هذه الطريقة مجموعة من طلبات EmbedContent إلى قائمة الانتظار لمعالجتها بشكل مجمّع.
batchEmbedContents POST /v1beta/{model=models/*}:batchEmbedContents
تنشئ هذه الدالة متّجهات تضمين متعدّدة من الإدخال Content الذي يتألف من مجموعة من السلاسل الممثّلة كعناصر EmbedContentRequest.
batchEmbedText POST /v1beta/{model=models/*}:batchEmbedText
تنشئ هذه الطريقة عمليات تضمين متعددة من النموذج بالاستناد إلى النص المُدخَل في طلب متزامن.
batchGenerateContent POST /v1beta/{batch.model=models/*}:batchGenerateContent
تضيف هذه الطريقة مجموعة من طلبات GenerateContent إلى قائمة الانتظار لمعالجتها بشكل مجمّع.
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 Embedding المحدّد.
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
تعرض هذه الطريقة Models المتاحة من خلال Gemini API.
predict POST /v1beta/{model=models/*}:predict
يُجري طلبًا للحصول على عبارة بحث مقترَحة.
predictLongRunning POST /v1beta/{model=models/*}:predictLongRunning
تعمل هذه الطريقة مثل طريقة Predict، ولكنها تعرض عملية طويلة الأمد (LRO).
streamGenerateContent POST /v1beta/{model=models/*}:streamGenerateContent
تنشئ هذه الدالة ردًا متسلسلاً من النموذج استنادًا إلى الإدخال GenerateContentRequest.