메서드: models.countTokens
- 엔드포인트
- 경로 매개변수
- 요청 본문
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 응답 본문
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 승인 범위
- 요청 예시 <ph type="x-smartling-placeholder">
- GenerateContentRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
입력 콘텐츠에 대해 모델의 tokenizer를 실행하고 토큰 수를 반환합니다.
엔드포인트
<ph type="x-smartling-placeholder"></ph> 게시물
https://generativelanguage.googleapis.com/v1beta/{model=models/*}:countTokens
경로 매개변수
model
string
필수 항목입니다. 모델의 리소스 이름입니다. 이는 모델에서 사용할 ID 역할을 합니다.
이 이름은 models.list
메서드에서 반환하는 모델 이름과 일치해야 합니다.
형식: models/{model}
models/{model}
형식을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
<ph type="x-smartling-placeholder">contents[]
object (Content
)
선택사항. 프롬프트로 모델에 제공되는 입력입니다. generateContentRequest
가 설정되면 이 필드는 무시됩니다.
generateContentRequest
object (GenerateContentRequest
)
선택사항. 모델에 제공되는 전체 입력입니다. model.countTokens는 프롬프트, 함수 호출 등을 집계합니다.
요청 예시
텍스트
Python
Node.js
Shell
Kotlin
Swift
Dart
자바
채팅
Python
Node.js
Shell
Kotlin
Swift
Dart
자바
인라인 미디어
Python
Node.js
Kotlin
Swift
Dart
자바
파일
Python
Node.js
캐시
Python
Node.js
시스템 안내
Python
Node.js
Kotlin
Swift
Dart
자바
도구
Python
Node.js
Kotlin
Swift
Dart
자바
응답 본문
models.countTokens
님의 응답입니다.
prompt
에 모델의 tokenCount
를 반환합니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
totalTokens
integer
model
가 prompt
를 토큰화하는 토큰 수입니다.
항상 음수가 아닙니다. 캐시된Content가 설정되어 있어도 이 값은 여전히 총 유효 프롬프트 크기입니다. 예: 여기에는 캐시된 콘텐츠의 토큰 수가 포함됩니다.
JSON 표현 |
---|
{ "totalTokens": integer } |
GenerateContentRequest
모델에서 완료 생성 요청입니다.
JSON 표현 |
---|
{ "model": string, "contents": [ { object ( |
model
string
필수 항목입니다. 완료를 생성하는 데 사용할 Model
의 이름입니다.
형식: name=models/{model}
contents[]
object (Content
)
필수 항목입니다. 모델과의 현재 대화 콘텐츠입니다.
싱글턴 쿼리의 경우 이는 단일 인스턴스입니다. 멀티턴 쿼리의 경우 대화 기록과 최신 요청이 포함된 반복되는 필드입니다.
tools[]
object (Tool
)
선택사항. 모델이 다음 응답을 생성하는 데 사용할 수 있는 Tools
목록입니다.
Tool
는 시스템이 외부 시스템과 상호작용하여 모델의 지식과 범위를 벗어난 작업 또는 작업 집합을 실행할 수 있도록 하는 코드입니다. 현재 지원되는 유일한 도구는 Function
입니다.
toolConfig
object (ToolConfig
)
선택사항. 요청에 지정된 Tool
의 도구 구성입니다.
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가 지원됩니다.
systemInstruction
object (Content
)
선택사항. 개발자가 설정한 시스템 안내입니다. 현재는 텍스트만 지원합니다.
generationConfig
object (GenerationConfig
)
선택사항. 모델 생성 및 출력을 위한 구성 옵션입니다.
cachedContent
string
선택사항. 예측을 제공하는 컨텍스트로 사용되는 캐시된 콘텐츠의 이름입니다. 참고: 사용자가 캐싱 (예: 캐시할 콘텐츠)을 제어할 수 있고 비용 절감이 보장되는 명시적 캐싱에서만 사용됩니다. 형식: cachedContents/{cachedContent}