Gemini 네이티브
토큰 수 계산
생성이나 과금 없이 Gemini 요청의 입력 토큰 수를 계산합니다.
Gemini 요청을 전송하기 전에 해당 요청의 입력 토큰 수를 계산합니다. 이 호출은 과금되지 않으며 계정 잔액이 필요하지 않지만, API 키는 필요합니다. 모델 가져오기 응답의 supportedGenerationMethods에 countTokens가 나열되어 있는 모델과 함께 사용하세요.
contents 또는 전체 generateContentRequest 중 하나를 전송합니다. 계산된 토큰 수는 사전 계획 용도로 사용하세요. 생성 요청에 대한 요금은 해당 응답의 usageMetadata를 기준으로 청구됩니다.
인증
콘텐츠 생성 (Generate Content)와 동일: ?key=, x-goog-api-key 또는 Authorization: Bearer.
요청 본문
contentsarray
콘텐츠 생성 (Generate Content)와 동일한 형식의 대화 내용입니다.
generateContentRequestobject
contents 대신 토큰 수를 계산할 전체 Gemini 생성 요청입니다. generate_content_request도 허용됩니다.
오류
400 INVALID_ARGUMENT: 본문이 유효하지 않거나 모델이 Gemini 요청을 수락하지 않습니다.401 UNAUTHENTICATED: API 키가 누락되었거나 유효하지 않습니다.503 UNAVAILABLE: 현재 해당 모델에 사용 가능한 경로가 없습니다. 나중에 다시 시도하세요.
요청
curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:countTokens" \
-H "x-goog-api-key: sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [{"text": "Hello, Gemini!"}]
}
]
}'응답
{
"totalTokens": 7
}totalTokensinteger
요청의 입력 토큰 수입니다.