TokenLab

핵심 가이드

청구 및 가격 책정

요금, 예상 비용, 잔액 및 한도 작동 방식

하나의 TokenLab 잔액은 모든 모델에서 공통으로 사용됩니다. 구독이나 최소 사용 금액은 없습니다. 충전은 $5부터 시작합니다. 요금은 각 요청에 대해 기록된 모델 및 사용량에 따라 결정됩니다.

제공 옵션

동일한 모델과 API를 두 가지 경로로 이용할 수 있습니다. Verified는 비용이 더 저렴하고, Official은 더 안정적입니다. 제공 옵션에 따라 요청을 실행할 경로와 지불할 가격이 결정됩니다.

옵션경로가격경로를 사용할 수 없는 경우
VerifiedVerified 전용: TokenLab에서 테스트한 경로Verified 가격 (대부분의 모델에서 Official 가격보다 저렴)요청이 실패하며 요금이 청구되지 않음
OfficialOfficial 전용: 모델 제작사 또는 주요 플랫폼Official 가격 (모델 제작사가 게시한 가격)요청이 실패하며 요금이 청구되지 않음
Auto (기본값)Verified 우선. Verified에 공급이 없거나 출력 전에 실패할 경우 Official이 1회 실행요청을 완료한 경로의 가격Official이 요청을 실행함

모델 페이지에서 각 모델의 두 가지 가격을 모두 확인할 수 있습니다.

  • 완료된 각 요청은 한 번만 청구됩니다.
  • Auto는 출력이 시작되거나 작업이 수락된 후에는 경로를 전환하지 않습니다.
  • 실행 전, Auto는 두 가지 가능한 금액 중 더 높은 금액을 보류합니다. 잔액이 Verified 예상 비용만 충당할 수 있는 경우, Auto는 해당 요청에 대해 Verified만 실행하며 Official로 대체하지 않습니다. 실행 후 실제 요금이 청구되고 나머지 금액은 반환됩니다.
  • X-TokenLab-Delivery-Policy 요청 헤더는 API 키 설정을 재정의하며, API 키 설정은 워크스페이스 기본값을 재정의합니다. API 소개를 참조하세요.

유료 생성의 경우, 콘솔(Console)에서 확인 전 최대 예상 비용을 보여줍니다. 완료 후, 실행(Runs) 및 사용량(Usage)에서 최종 청구 금액과 요청을 완료한 옵션을 확인할 수 있습니다.

가격 책정 모델

모델 가격은 변경될 수 있습니다. 현재 가격은 콘솔, 모델 페이지, GET /v1/models/:model/pricing 또는 가격 책정 API에서 확인하세요.

모델 페이지에서 Verified 가격 또는 할인 열의 대시는 현재 이용 가능한 Verified 제안이 없음을 의미하며, 무료라는 뜻은 아닙니다. Official 공급이 있는 모델은 Official 또는 Auto를 통해 계속 이용할 수 있습니다. API에서 해당 모델의 Verified 가격 필드는 null이거나 생략되며, official_* 가격 필드에 지불할 금액이 표시됩니다. 제공 라벨은 지원되는 옵션을 설명하며, 가용성은 각 요청이 실행될 때 확인됩니다. 시리즈 가격은 관련 제공 옵션에 공급이 있는 모델을 요약하며 서로 다른 청구 단위를 구분합니다.

토큰 기반 가격 책정

대부분의 채팅, 추론, 임베딩, 리랭크(rerank) 및 일부 이미지 모델은 입력, 출력, 캐시 또는 이미지 출력 토큰 단위로 가격이 책정됩니다.

가격 책정 제품군예시현재 가격 확인 방법
채팅 / 응답gpt-5.4, claude-sonnet-4-6, gemini-3.6-flash모델 페이지 또는 가격 책정 API
임베딩 / 리랭크text-embedding-3-small, qwen3-vl-rerank모델 가격 상세 정보
토큰 기반 이미지gpt-image-2GET /v1/models/gpt-image-2/pricing

복사한 가격 표를 하드코딩하지 마세요. 애플리케이션에서 비용을 표시하거나 비교해야 할 때 현재 가격을 불러오세요.

도구 수수료

일부 내장 도구는 토큰 외에 추가 비용이 발생합니다. TokenLab은 모델이 도구를 사용하고 응답에서 이를 보고할 때만 도구 수수료를 청구합니다. 모델이 사용하지 않는 도구를 제공하는 요청에는 도구 수수료가 부과되지 않습니다.

도구모델요금
웹 검색OpenAI, Claude 및 Grok 모델, Google 검색 그라운딩을 사용하는 Gemini 3 모델모델이 실행하는 각 검색. Gemini 3의 경우 고유한 각 검색 쿼리
검색 그라운딩Google 검색 그라운딩을 사용하는 Gemini 2.5 모델검색이 그라운딩된 각 요청당 1회
  • 각 모델은 토큰 가격과 마찬가지로 Verified 및 Official에 대한 자체 도구 수수료를 가집니다. 모델의 가격 상세 정보에는 웹 검색(Web search) 또는 **검색 그라운딩(Search grounding)**으로 표시됩니다.
  • 모델이 읽는 검색 결과는 모델 가격에 따라 입력 토큰으로 청구됩니다.
  • 모델에 가격이 책정되지 않은 도구는 요금이 부과되지 않습니다.
  • 콘솔의 실행(Runs)에서 요청을 열면 **도구 수수료(Tool fees)**에 호출 횟수와 각 호출의 가격이 표시됩니다. API 키 사용 기록에는 charged_price_basis에 동일한 값이 기록됩니다. measure.dimensions.webSearchCalls 또는 groundedPrompts에 횟수가, effectiveUnitPrices.webSearch 또는 effectiveUnitPrices.groundedPrompt에 각 호출의 가격이 표시됩니다.

프롬프트 캐싱

모델은 캐시에서 프롬프트의 반복되는 시작 부분을 읽을 수 있습니다. 캐시에서 읽은 토큰은 입력 토큰보다 비용이 저렴합니다.

  • GPT, Gemini 및 기타 일부 모델은 길고 반복되는 프롬프트를 자동으로 캐시합니다. 별도의 설정은 필요 없습니다.
  • Claude 모델은 요청 시에만 캐시합니다. 채팅 완료 요청에서 "anthropic_options": {"prompt_caching": true}를 전송하세요. TokenLab은 시스템 프롬프트의 끝과 최신 사용자 메시지를 캐시 지점으로 표시합니다. 메시지 API를 사용하는 경우, 블록에 직접 cache_control을 추가하세요.
요금입력 가격 대비
캐시 쓰기, 5분 (기본값)더 높음
캐시 쓰기, 1시간 ("prompt_caching_ttl": "1h")5분 쓰기보다 높음
캐시 읽기더 낮음
  • 캐시 가격은 모델 및 제공 옵션에 따라 다릅니다. 비율을 신뢰하기 전에 모델 페이지나 가격 책정 API에서 해당 모델의 캐시 가격을 확인하세요.
  • 반복되지 않는 프롬프트는 캐시 쓰기 작업으로 인해 캐싱을 켰을 때 비용이 약간 더 발생합니다.
  • 모델의 최소 캐시 가능 길이보다 짧은 프롬프트는 캐시되지 않으며 캐시 쓰기 요금이 부과되지 않습니다.
  • 1시간 캐시는 모든 모델에서 사용할 수 없습니다. 모델에 표시되지 않으면 5분 캐시를 사용하세요.
  • 응답에 결과가 표시됩니다. usage.prompt_tokens_details.cached_tokens는 캐시에서 읽은 토큰 수입니다. usage.cache_creation_input_tokens는 캐시에 기록된 토큰 수이며, 0보다 클 때만 나타납니다.

서비스 티어

TokenLab은 표준 서비스 티어에서 요청을 실행하고 청구합니다. service_tier 값으로 auto 및 default가 허용됩니다. flex, priority, fast, ultrafast와 같은 다른 값은 무시되며, 요청은 표준 티어에서 실행되고 표준 가격이 청구됩니다.

요청 및 작업 가격 책정

이미지, 비디오, 음악, 3D, 오디오 및 월드 모델은 요청, 이미지, 초, 분 또는 작업 단위로 가격이 책정될 수 있습니다. 모델 페이지에 청구 단위가 표시됩니다.

제품군예시
이미지flux-pro-1.1
비디오veo3.1, seedance-2.0
음악suno-music
3Dtripo-h3.1
오디오grok-tts, whisper-large-v3

비동기 작업 청구

일부 작업은 생성 시 예상 비용을 예약합니다. 완료된 작업은 한 번 청구되며, 실패한 작업은 보류 중인 금액을 해제하거나 환불합니다.

비디오, 음악, 3D 및 작업 기반 이미지 생성은 작업 ID와 poll_url을 반환합니다. 최종 금액은 작업이 completed 또는 failed 상태가 된 후 기록됩니다. 완료된 작업에는 청구 후 billing_transaction_id가 포함되며, 실패한 작업은 청구되지 않습니다.

작업 완료 후에도 사용량(Usage)에 최종 청구 금액이나 해제된 금액이 표시되지 않으면 요청 ID와 작업 ID를 포함하여 hello@tokenlab.sh로 문의하세요.

청구 트랜잭션 ID

스트리밍되지 않는 OpenAI 호환 응답에는 응답 전송 전 청구가 완료된 경우 billing_transaction_id가 포함됩니다. 동일한 값이 X-Billing-Transaction-ID에 나타날 수 있으며, Gemini 및 기타 네이티브 형식은 이 헤더에만 노출될 수 있습니다.

비동기 작업에는 완료 후 billing_transaction_id가 포함됩니다. 스트리밍은 청구보다 먼저 완료될 수 있으므로 헤더가 없는 경우 사용량(Usage)을 확인하세요.

토큰 수

텍스트 모델은 일반적으로 usage에 입력, 출력 및 총 토큰 수를 보고합니다. 토큰화는 모델, 언어 및 미디어 입력에 따라 다르므로 문자 수 공식은 신뢰할 수 있는 청구 예상치가 아닙니다. 모델의 현재 가격과 최종 사용량 기록을 사용하세요.

사용량 확인

사용량(Usage)에서 다음을 확인할 수 있습니다.

  • 실시간 잔액
  • 모델별 사용 내역
  • 비용 상세 내역
  • API 키 사용량

API 응답

토큰 기반 응답에는 일반적으로 다음과 같은 사용량 정보가 포함됩니다.

{
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

비용 절감

잔액 부족 알림

**콘솔(Console) → 설정(Settings)**에서 임계값을 설정하세요. 잔액이 설정값 아래로 떨어지면 TokenLab이 이메일을 보냅니다.

잔액 추가

**콘솔(Console) → 청구(Billing)**를 열고 금액을 선택한 다음 결제 시 표시되는 결제 방법 중 하나를 사용하세요. 결제 제공업체가 결제를 확인하면 잔액이 업데이트됩니다.

체험 크레딧 제공 기간 동안, 자격을 갖춘 신규 계정은 최대 10회 호출까지 사용할 수 있는 $0.25의 일회성 체험 크레딧을 받습니다. 사용하지 않은 체험 크레딧은 7일 후에 만료됩니다.

잔액 부족으로 요청이 중단되지 않게 하려면 청구(Billing)에서 **자동 충전(Automatic funding)**을 켜세요. 잔액이 설정한 금액 아래로 떨어지면 월간 한도 내에서 자동으로 자금을 추가합니다.

API 키 한도

**콘솔(Console) → API 키(API Keys)**에서 API 키를 생성하거나 편집할 때 지출 한도를 설정할 수 있습니다.

한도에 도달하면 해당 키를 사용하는 요청은 quota_exceeded 코드와 함께 402 오류를 반환합니다. 계속 사용하려면 한도를 높이거나 제거하세요.

청구 관련 도움말

청구 관련 문의는 hello@tokenlab.sh로 연락해 주세요.

이 페이지의 내용