Method: models.batchEmbedText

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

HTTP 요청

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

URL은 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

선택사항입니다. 모델이 임베딩으로 변환할 자유 형식 입력 텍스트입니다.