Method: models.batchEmbedText

從同步呼叫中所列的特定輸入文字產生多個嵌入。

HTTP 要求

POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:batchEmbedText

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
model

string

必要欄位。用於產生嵌入的 Model 名稱。範例：model/embedding-gecko-001

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "texts": [
    string
  ],
  "requests": [
    {
      object (EmbedTextRequest)
    }
  ]
}
欄位
texts[]

string

選用設定。任意形式的輸入文字，模型會變為嵌入。目前的文字上限為 100 段文字，超過這個數量將擲回錯誤。
requests[]

object (EmbedTextRequest)

選用設定。為該批次嵌入嵌入要求。只能設定 texts 或 requests 其中之一。

回應主體

EmbedTextRequest 的回應。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "embeddings": [
    {
      object (Embedding)
    }
  ]
}
欄位
embeddings[]

object (Embedding)

僅供輸出。根據輸入文字產生的嵌入。

授權範圍

需要下列其中一種 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

詳情請參閱驗證總覽。

EmbedTextRequest

要求從模型取得文字嵌入。

JSON 表示法 
{
  "model": string,
  "text": string
}
欄位
model

string

必要欄位。用於以下格式的模型名稱：model=models/{model}。
text

string

選用設定。任意形式的輸入文字，模型會變為嵌入。