메인 콘텐츠로 건너뛰기

​
개요

TokenLab는 **종량제 요금제(pay-as-you-go)**를 사용합니다. 구독이나 최소 약정 없이 사용한 만큼만 비용을 지불하면 됩니다.

​
결제 방식

  1. 계정에 크레딧 추가
  2. API 사용 - 요청당 비용이 차감됩니다
  3. 대시보드에서 사용량 모니터링
  4. 잔액이 부족할 때 충전

​
요금 모델

실시간 가격은 제공자, 라우트, 모델 계약에 따라 바뀔 수 있습니다. Dashboard, 모델 페이지, GET /v1/models/:model/pricing, Pricing API를 기준으로 삼으세요.

​
토큰 기반 요금

대부분의 chat, reasoning, embedding, rerank 및 일부 이미지 모델은 입력, 출력, 캐시 또는 이미지 출력 token 기준으로 과금됩니다.
요금 유형예시현재 가격 확인
Chat / Responsesgpt-5.4, claude-sonnet-4-6, gemini-3.5-flash模型页或 Pricing API
嵌入 / reranktext-embedding-3-small, qwen3-vl-rerank模型价格详情
按 token 计费的图像gpt-image-2GET /v1/models/gpt-image-2/pricing
정적 가격표를 프로덕션 로직에 복사하지 마세요. 코드에는 model ID만 저장하고 출시 전에 현재 가격을 가져오거나 검토하세요.

​
요청 및 작업 기반 요금

이미지, 비디오, 음악, 3D, 오디오, world 생성 모델은 요청, 이미지, 초/분, 작업 또는 제공자별 사용량 기준으로 과금될 수 있습니다.
제품군예시
图像flux-pro, qwen-image-plus
视频veo3.1, seedance-2.0
音乐suno-music
3Dtripo-h3.1
音频tts-1, whisper-1

​
비동기 작업 결제 (비디오/음악/3D 및 일부 이미지 모델)

작업 기반 생성에서는 작업 생성 시 예상 비용이 예약되거나 선차감될 수 있습니다. 최종 정산은 폴링 또는 최종화 과정에서 비동기 작업이 성공 터미널 상태에 도달한 뒤에만 완료됩니다.
작업 기반 생성 흐름(비디오, 음악, 3D 및 일부 이미지 모델)의 경우:
  1. 작업을 제출합니다. TokenLab는 잔액과 API Key 사용 한도를 확인하기 위해 예상 금액을 선차감하거나 예약할 수 있습니다.
  2. 반환된 poll_url을 폴링하거나 GET /v1/tasks/{id}를 호출하여 작업이 터미널 상태가 될 때까지 확인합니다.
  3. 작업이 성공적으로 완료되면 최종 정산이 사용량을 기록하고, 작업 응답에 billing_transaction_id가 포함됩니다.
  4. 생성이 실패하거나 터미널 상태가 failed이면 보류 중인 금액이 환불되거나 해제되고 요청은 비과금으로 표시됩니다.
터미널 상태가 확인된 뒤에도 dashboard에 정산 또는 환불이 반영되지 않으면 support@tokenlab.sh로 문의하세요. 
# 예시: 비디오 생성 결제
response = client.post("/v1/videos/generations", json={
    "model": "veo3.1",
    "prompt": "A sunset over the ocean"
})
# 예상 비용이 지금 예약될 수 있습니다. 최종 청구는 성공 후 표시됩니다.

poll_url = response.json()["poll_url"]
task_id = response.json()["task_id"]
# 상태 확인을 위해 poll_url을 폴링하세요. 정산 후 billing_transaction_id가 표시됩니다.

​
청구 거래 ID

과금 대상 OpenAI 호환 비스트리밍 JSON 응답은 응답이 확정되기 전에 정산이 완료된 경우 billing_transaction_id 를 포함합니다. 같은 값은 X-Billing-Transaction-ID 응답 헤더로도 노출되어 브라우저와 서버 통합에서 읽을 수 있습니다. Gemini /v1beta 같은 네이티브 호환 라우트는 provider 고유 응답 형상을 유지하기 위해 헤더로만 값을 노출할 수 있습니다. 비동기 미디어 작업은 생성 응답의 poll_url 또는 GET /v1/tasks/{id} 를 폴링하세요. 정산이 완료되면 작업 응답에 billing_transaction_id 가 포함됩니다. 스트리밍 응답은 스트림 전송 후에 정산될 수 있으므로 헤더가 없으면 dashboard 사용 로그로 대조하세요.

​
토큰 계산

토큰은 텍스트 처리의 기본 단위입니다:
  • 약 4자 = 1 토큰 (영어)
  • 약 1-2자 = 1 토큰 (중국어)
  • 이미지 1개 = 크기 및 세부 정보에 따라 다름

​
토큰 추정

# 대략적인 추정
def estimate_tokens(text):
    return len(text) / 4  # 영어 기준 근사치

# 실제 개수 (OpenAI 모델 기준)
import tiktoken
encoder = tiktoken.encoding_for_model("gpt-4o")
tokens = encoder.encode("Your text here")
print(f"Token count: {len(tokens)}")

​
사용량 추적

​
대시보드

대시보드에서 사용량을 모니터링하세요:
  • 실시간 잔액
  • 모델별 사용 기록
  • 비용 내역
  • API 키 사용량

​
API 응답

각 응답에는 사용량 정보가 포함됩니다: 
{
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

​
비용 최적화

단순한 작업에는 더 작은 모델(GPT-4o-mini, Gemini Flash)을 사용하세요.
반복되는 동일한 요청에 대해 응답을 캐싱하세요.
명확성을 유지하면서 프롬프트를 간결하게 작성하세요.
전체 응답이 필요하지 않은 경우 응답 길이를 제한하세요.
스트리밍은 추가 비용이 들지 않으면서 체감 성능을 향상시킵니다.

​
잔액 부족 알림

잔액이 떨어질 때 알림을 받도록 설정하세요:
  1. 대시보드 → 설정 → 알림으로 이동
  2. 임계값 금액 설정
  3. 이메일 알림 수신

​
크레딧 추가

​
결제 수단

  • Stripe (Visa, Mastercard)

​
단계

  1. 대시보드에 로그인
  2. 크레딧 추가 클릭
  3. 금액 및 결제 수단 선택
  4. 결제 완료
결제 확인 후 크레딧이 즉시 추가됩니다.

​
API 키 제한

개별 API 키에 지출 제한을 설정할 수 있습니다:
  1. 대시보드 → API 키로 이동
  2. 편집할 키 클릭
  3. 사용 제한 설정
제한에 도달하면 해당 키를 사용한 요청은 402 Payment Required를 반환합니다.

​
인보이스

비즈니스 계정의 경우 인보이스를 이용할 수 있습니다:
  1. 대시보드 → 결제로 이동
  2. 거래 내역 보기
  3. 인보이스를 PDF로 다운로드

​
질문이 있으신가요?

결제 관련 문의는 support@tokenlab.sh로 연락해 주세요.