Method: models.batchEmbedContents

동기 호출로 입력 텍스트가 지정된 모델에서 여러 임베딩을 생성합니다.

HTTP 요청

POST https://generativelanguage.googleapis.com/v1/{model=models/*}:batchEmbedContents

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
model

string

필수 항목입니다. 모델의 리소스 이름입니다. 이는 모델에서 사용할 ID로 사용됩니다.

이 이름은 models.list 메서드에서 반환하는 모델 이름과 일치해야 합니다.

형식: models/{model}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "requests": [
    {
      object (EmbedContentRequest)
    }
  ]
}
입력란
requests[]

object (EmbedContentRequest)

필수 항목입니다. 배치에 대한 요청을 삽입합니다. 각 요청의 모델은 BatchEmbedContentsRequest.model로 지정된 모델과 일치해야 합니다.

응답 본문

BatchEmbedContentsRequest에 대한 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "embeddings": [
    {
      object (ContentEmbedding)
    }
  ]
}
입력란
embeddings[]

object (ContentEmbedding)

출력 전용입니다. 일괄 요청에 제공된 것과 동일한 순서로 각 요청의 임베딩입니다.

승인 범위

다음 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 (Content)
  },
  "taskType": enum (TaskType),
  "title": string,
  "outputDimensionality": integer
}
입력란
model

string

필수 항목입니다. 모델의 리소스 이름입니다. 이는 모델에서 사용할 ID로 사용됩니다.

이 이름은 models.list 메서드에서 반환하는 모델 이름과 일치해야 합니다.

형식: models/{model}
content

object (Content)

필수 항목입니다. 삽입할 콘텐츠입니다. parts.text 필드만 계산됩니다.
taskType

enum (TaskType)

선택사항입니다. 임베딩이 사용될 태스크 유형입니다(선택사항). models/embedding-001에만 설정할 수 있습니다.
title

string

선택사항입니다. 텍스트의 제목입니다(선택사항). TaskType이 RETRIEVAL_DOCUMENT인 경우에만 적용됩니다.

참고: RETRIEVAL_DOCUMENT에 title를 지정하면 검색 시 더 나은 품질의 임베딩이 제공됩니다.
outputDimensionality

integer

선택사항입니다. 출력 임베딩의 축소된 차원(선택사항)입니다. 설정하면 출력 임베딩에 과도한 값이 있으면 끝부터 잘립니다. 2024년 이후 최신 모델에서 지원되며 이전 모델 (models/embedding-001)에서는 이 값을 지정할 수 없습니다.