입력 콘텐츠에서 모델의 tokenizer를 실행하고 토큰 수를 반환합니다.
HTTP 요청
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:countTokens
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
model |
필수 항목입니다. 모델의 리소스 이름입니다. 이는 모델에서 사용할 ID로 사용됩니다. 이 이름은 형식: |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "contents": [ { object ( |
입력란 | |
---|---|
contents[] |
선택사항입니다. 프롬프트로 모델에 제공되는 입력입니다. |
generateContentRequest |
선택사항입니다. 모델에 지정된 전체 입력입니다. models.countTokens는 프롬프트, 함수 호출 등을 집계합니다. |
응답 본문
models.countTokens
의 응답
이 메서드는 prompt
에 대해 모델의 tokenCount
를 반환합니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "totalTokens": integer } |
입력란 | |
---|---|
totalTokens |
항상 음수가 아닙니다. |
승인 범위
다음 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 ( |
입력란 | |
---|---|
model |
필수 항목입니다. 완료를 생성하는 데 사용할 형식: |
contents[] |
필수 항목입니다. 모델과의 현재 대화 콘텐츠입니다. 싱글턴 쿼리의 경우 이는 단일 인스턴스입니다. 멀티턴 쿼리의 경우 대화 기록 + 최근 요청이 포함된 반복 필드입니다. |
tools[] |
선택사항입니다. 모델이 다음 응답을 생성하는 데 사용할 수 있는
|
toolConfig |
선택사항입니다. 요청에 지정된 |
safetySettings[] |
선택사항입니다. 안전하지 않은 콘텐츠를 차단하기 위한 고유한 이는 |
systemInstruction |
선택사항입니다. 개발자가 시스템 명령을 설정합니다. 현재는 텍스트만 지원됩니다. |
generationConfig |
선택사항입니다. 모델 생성 및 출력을 위한 구성 옵션입니다. |