چندین جاسازی را از مدل متن ورودی داده شده در یک تماس همزمان ایجاد می کند.
درخواست HTTP
POST https://generativelanguage.googleapis.com/v1/{model=models/*}:batchEmbedContents
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
model | ضروری. نام منبع مدل این به عنوان شناسه ای برای استفاده از مدل عمل می کند. این نام باید با نام مدلی که با روش قالب: |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"requests": [
{
object ( |
زمینه های | |
---|---|
requests[] | ضروری. جاسازی درخواستها برای دسته مدل در هر یک از این درخواست ها باید با مدل مشخص شده |
بدن پاسخگو
پاسخ به BatchEmbedContentsRequest
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"embeddings": [
{
object ( |
زمینه های | |
---|---|
embeddings[] | فقط خروجی جاسازیها برای هر درخواست، به همان ترتیبی که در درخواست دستهای ارائه شده است. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/generative-language
-
https://www.googleapis.com/auth/generative-language.tuning
-
https://www.googleapis.com/auth/generative-language.tuning.readonly
-
https://www.googleapis.com/auth/generative-language.retriever
-
https://www.googleapis.com/auth/generative-language.retriever.readonly
برای اطلاعات بیشتر، به نمای کلی احراز هویت مراجعه کنید.
EmbedContentRequest
درخواست حاوی Content
برای جاسازی مدل.
نمایندگی JSON |
---|
{ "model": string, "content": { object ( |
زمینه های | |
---|---|
model | ضروری. نام منبع مدل این به عنوان شناسه ای برای استفاده از مدل عمل می کند. این نام باید با نام مدلی که با روش قالب: |
content | ضروری. محتوایی که باید جاسازی شود. فقط قسمتهای |
taskType | اختیاری. نوع کار اختیاری که جاسازیها برای آن استفاده خواهند شد. فقط برای |
title | اختیاری. عنوان اختیاری برای متن فقط زمانی قابل اعمال است که TaskType توجه: تعیین |
outputDimensionality | اختیاری. ابعاد کاهش یافته اختیاری برای جاسازی خروجی. اگر تنظیم شود، مقادیر بیش از حد در جاسازی خروجی از انتها کوتاه می شوند. از سال 2024 توسط مدل های جدیدتر پشتیبانی می شود و مدل قبلی ( |