Method: models.countTokens

입력 콘텐츠에서 모델의 tokenizer를 실행하고 토큰 수를 반환합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
model

string

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

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

형식: models/{model}

요청 본문

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

JSON 표현 
{
  "contents": [
    {
      object (Content)
    }
  ],
  "generateContentRequest": {
    object (GenerateContentRequest)
  }
}
입력란
contents[]

object (Content)

선택사항입니다. 프롬프트로 모델에 제공되는 입력입니다. generateContentRequest가 설정되면 이 필드는 무시됩니다.
generateContentRequest

object (GenerateContentRequest)

선택사항입니다. 모델에 지정된 전체 입력입니다. models.countTokens는 프롬프트, 함수 호출 등을 집계합니다.

응답 본문

models.countTokens의 응답

이 메서드는 prompt에 대해 모델의 tokenCount를 반환합니다.

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

JSON 표현 
{
  "totalTokens": integer
}
입력란
totalTokens

integer

model가 prompt를 토큰화하는 토큰 수입니다.

항상 음수가 아닙니다.

승인 범위

다음 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

자세한 내용은 인증 개요를 참조하세요.

GenerateContentRequest

모델에서 완료를 생성하기 위한 요청입니다.

JSON 표현 
{
  "model": string,
  "contents": [
    {
      object (Content)
    }
  ],
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "generationConfig": {
    object (GenerationConfig)
  }
}
입력란
model

string

필수 항목입니다. 완료를 생성하는 데 사용할 Model의 이름입니다.

형식: name=models/{model}
contents[]

object (Content)

필수 항목입니다. 모델과의 현재 대화 콘텐츠입니다.

싱글턴 쿼리의 경우 이는 단일 인스턴스입니다. 멀티턴 쿼리의 경우 대화 기록 + 최근 요청이 포함된 반복 필드입니다.
safetySettings[]

object (SafetySetting)

선택사항입니다. 안전하지 않은 콘텐츠를 차단하기 위한 고유한 SafetySetting 인스턴스의 목록입니다.

이는 GenerateContentRequest.contents 및 GenerateContentResponse.candidates에 적용됩니다. 각 SafetyCategory 유형에 설정이 두 개 이상 있으면 안 됩니다. API는 이러한 설정에 의해 설정된 기준점을 충족하지 않는 모든 콘텐츠와 응답을 차단합니다. 이 목록은 safetySettings에 지정된 각 SafetyCategory의 기본 설정을 재정의합니다. 목록에 제공된 특정 SafetyCategory의 SafetySetting가 없으면 API는 카테고리의 기본 안전 설정을 사용합니다. 유해 카테고리 HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT가 지원됩니다.
generationConfig

object (GenerationConfig)

선택사항입니다. 모델 생성 및 출력을 위한 구성 옵션입니다.