TokenLab

Gemini 네이티브

토큰 수 계산

생성이나 과금 없이 Gemini 요청의 입력 토큰 수를 계산합니다.

POST
/v1beta/models/{model}:countTokens

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
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!"}]
      }
    ]
  }'

응답

200 OK
{
  "totalTokens": 7
}
totalTokensinteger
요청의 입력 토큰 수입니다.

인증

AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

경로 매개변수

model*string

모델 이름 (예: gemini-2.5-pro)

쿼리 매개변수

key?string

API 키 (헤더 인증의 대안)

요청 본문

application/json

응답

application/json

application/json

application/json

application/json