Generative Language API

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

مورد RST: v1beta.cachedContents
مصدر RST: v1beta.corpora
مصدر RST: v1beta.corpora.documents
مصدر RST: v1beta.corpora.documents.chunks
مورد RST: v1beta.corpora.permissions
مورد RST: v1beta.files
مورد RST: v1beta.media
مورد RST: v1beta.models
مورد RST: v1beta.tunedModels
مورد RST: v1beta.tunedModels.permissions
مورد RST: v1.models
مصدر RST: v1.operations
مورد RST: v1.tunedModels
مورد RST: v1.tunedModels.operations

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

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

مستند Discovery

مستند الاستكشاف هو مواصفة يمكن للآلة قراءتها، لوصف واجهات برمجة تطبيقات REST واستخدامها. يُستخدم لإنشاء مكتبات للعملاء، ومكونات IDE الإضافية، وأدوات أخرى تتفاعل مع Google APIs. قد توفّر خدمة واحدة مستندات استكشاف متعددة. توفّر هذه الخدمة مستندات الاكتشاف التالية:

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

نقطة نهاية الخدمة هي عنوان 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` يسرد المحتوى الذي تم تخزينه مؤقتًا.
`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` تنشئ هذه الدالة تضمينات متعددة من النموذج الذي يحتوي على نص إدخال في مكالمة متزامنة.
`batchEmbedText`	`POST /v1beta/{model=models/*}:batchEmbedText` تنشئ هذه الدالة تضمينات متعددة من النموذج الذي يحتوي على نص إدخال في مكالمة متزامنة.
`countMessageTokens`	`POST /v1beta/{model=models/*}:countMessageTokens` يشغّل أداة إنشاء الرموز المميّزة الخاصة بالنموذج على سلسلة وتعرض عدد الرموز المميّزة.
`countTextTokens`	`POST /v1beta/{model=models/*}:countTextTokens` يشغّل أداة إنشاء الرموز المميّزة الخاصة بالنموذج على نصّ وعرض عدد الرموز المميّزة.
`countTokens`	`POST /v1beta/{model=models/*}:countTokens` يشغّل أداة إنشاء الرموز المميّزة الخاصة بالنموذج على محتوى الإدخال وعرض عدد الرموز المميّزة.
`embedContent`	`POST /v1beta/{model=models/*}:embedContent` تنشئ هذه الطريقة عملية تضمين من النموذج الذي يتم تحديده لمدخل `Content`.
`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/*}` يحصل هذا القسم على معلومات عن نموذج محدّد.
`list`	`GET /v1beta/models` يسرد النماذج المتوفّرة من خلال واجهة برمجة التطبيقات.
`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/*}` يتم تعديل نموذج تم ضبطه.
`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/}` يتم تعديل الإذن.

مورد REST: v1.models

الطُرق
`batchEmbedContents`	`POST /v1/{model=models/*}:batchEmbedContents` تنشئ هذه الدالة تضمينات متعددة من النموذج الذي يحتوي على نص إدخال في مكالمة متزامنة.
`countTokens`	`POST /v1/{model=models/*}:countTokens` يشغّل أداة إنشاء الرموز المميّزة الخاصة بالنموذج على محتوى الإدخال وعرض عدد الرموز المميّزة.
`embedContent`	`POST /v1/{model=models/*}:embedContent` تنشئ هذه الطريقة عملية تضمين من النموذج الذي يتم تحديده لمدخل `Content`.
`generateContent`	`POST /v1/{model=models/*}:generateContent` تنشئ هذه الدالة استجابة من النموذج استنادًا إلى إدخال `GenerateContentRequest`.
`get`	`GET /v1/{name=models/*}` يحصل هذا القسم على معلومات عن نموذج محدّد.
`list`	`GET /v1/models` يسرد النماذج المتوفّرة من خلال واجهة برمجة التطبيقات.
`streamGenerateContent`	`POST /v1/{model=models/*}:streamGenerateContent` تنشئ هذه الدالة استجابة يتم بثّها من النموذج استنادًا إلى إدخال `GenerateContentRequest`.

مورد REST: v1.operations

الطُرق
`delete`	`DELETE /v1/{name=operations/**}` حذف عملية طويلة الأمد
`list`	`GET /v1/{name}` يسرد العمليات التي تتطابق مع الفلتر المحدّد في الطلب.

مورد REST: v1.tunedModels

الطُرق
`generateContent`	`POST /v1/{model=tunedModels/*}:generateContent` تنشئ هذه الدالة استجابة من النموذج استنادًا إلى إدخال `GenerateContentRequest`.

مورد REST: v1.tunedModels.operations

الطُرق
`cancel`	`POST /v1/{name=tunedModels//operations/}:cancel` يبدأ الإلغاء غير المتزامن في عملية طويلة الأمد.
`get`	`GET /v1/{name=tunedModels//operations/}` يحصل على أحدث حالة لعملية طويلة الأمد.
`list`	`GET /v1/{name=tunedModels/*}/operations` يسرد العمليات التي تتطابق مع الفلتر المحدّد في الطلب.