메인 콘텐츠로 건너뛰기

Quick Start

자동 토큰 추적으로 2분 만에 시작하세요.

API Reference - Events Ingestion

사용량 이벤트 수집을 위한 완전한 API 문서입니다.

API Reference - Meters

청구를 위한 미터를 만들고 구성하는 방법을 알아보세요.

Usage-Based Billing Guide

미터를 활용한 사용량 기반 청구에 대한 종합 가이드입니다.
SaaS 앱, AI 챗봇, 콘텐츠 생성 도구 및 사용량 기반 청구가 필요한 모든 LLM 기반 애플리케이션에 적합합니다.

빠른 시작

자동 LLM 토큰 추적을 2분 만에 시작하세요:
1

Install the SDK

Dodo Payments 수집 블루프린트를 설치하세요:
2

Get Your API Keys

다음 두 개의 API 키가 필요합니다:
  • Dodo Payments API 키: Dodo Payments 대시보드에서 받으세요.
  • LLM 제공자 API 키: AI SDK, OpenAI, Anthropic, Groq 등에서 받으세요.
API 키를 환경 변수에 안전하게 저장하십시오. 버전 관리 시스템에 절대 커밋하지 마세요.
3

Create a Meter in Dodo Payments

사용량을 추적하기 전에 Dodo Payments 대시보드에서 미터를 생성하세요:
  1. 로그인 Dodo Payments 대시보드
  2. 이동 Products → Meters
  3. 클릭 “Create Meter”
  4. 미터 구성:
    • 미터 이름: 설명적인 이름을 선택하세요 (예: “LLM Token Usage”)
    • 이벤트 이름: 고유한 이벤트 식별자를 설정하세요 (예: llm.chat_completion)
    • 집계 유형: 토큰 수를 합산하려면 sum을 선택하세요
    • 추적 속성: 추적할 항목을 선택하세요:
      • inputTokens - 입력/프롬프트 토큰 추적
      • outputTokens - 출력/완료 토큰 추적(해당하는 경우 추론 토큰 포함)
      • totalTokens - 입력 + 출력 토큰 총합 추적
여기서 설정한 이벤트 이름은 SDK에 전달하는 값과 정확히 일치해야 합니다(대소문자 구분).
자세한 지침은 Usage-Based Billing Guide를 참조하세요.
4

Track Token Usage

LLM 클라이언트를 래핑하여 자동으로 추적을 시작하세요:
이제 모든 API 호출이 자동으로 토큰 사용을 추적하고 청구를 위해 Dodo Payments에 이벤트를 전송합니다.

구성

추적기 구성

필수 매개변수로 애플리케이션 시작 시 한 번 추적기를 생성하세요:
apiKey
string
필수
Dodo Payments API 키입니다. API Keys 페이지에서 가져오세요.
environment
string
필수
트래커의 환경 모드입니다.
  • test_mode - 개발 및 테스트용으로 사용
  • live_mode - 운영 환경에서 사용
개발 중에는 항상 test_mode을 사용하여 운영 메트릭에 영향을 주지 마세요.
eventName
string
필수
미터를 트리거하는 이벤트 이름입니다. Dodo Payments 미터에서 구성한 값과 정확히 일치해야 합니다(대소문자 구분).
이 이벤트 이름은 추적된 사용량을 청구 계산을 위한 올바른 미터와 연결합니다.

래퍼 구성

LLM 클라이언트를 래핑할 때 다음 매개변수를 제공하세요:
client
object
필수
LLM 클라이언트 인스턴스입니다(OpenAI, Anthropic, Groq 등).
customerId
string
필수
청구를 위한 고유 고객 식별자입니다. Dodo Payments에서 사용하는 고객 ID와 일치해야 합니다.
정확한 고객별 청구를 위해 애플리케이션의 사용자 ID 또는 고객 ID를 사용하세요.
metadata
object
추적 이벤트에 첨부할 선택적 추가 데이터입니다. 필터링 및 분석에 유용합니다.

전체 구성 예제

자동 추적: SDK는 응답을 수정하지 않고 백그라운드에서 토큰 사용량을 자동으로 추적합니다. 코드는 원래 제공자의 SDK를 사용할 때와 동일하게 깔끔하게 유지됩니다.

지원되는 제공자

LLM 블루프린트는 모든 주요 LLM 제공자 및 집계기와 원활하게 작동합니다:
범용 LLM 지원을 위해 Vercel AI SDK로 사용량을 추적하세요.
추적 항목:
  • inputTokensinputTokens
  • outputTokens + reasoningTokensoutputTokens
  • totalTokenstotalTokens
  • 모델 이름
AI SDK(예: 생각 모드가 있는 Google의 Gemini 2.5 Flash)를 통해 추론 기능이 있는 모델을 사용할 때 추론 토큰은 정확한 청구를 위해 outputTokens 계산에 자동으로 포함됩니다.
OpenRouter의 통합 API를 통해 200개 이상의 모델에서 토큰 사용량을 추적하세요.
추적 항목:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • 모델 이름
OpenRouter는 OpenAI, Anthropic, Google, Meta 및 기타 많은 공급자의 모델에 단일 API를 통해 액세스할 수 있게 합니다.
OpenAI의 GPT 모델에서 토큰 사용량을 자동으로 추적합니다.
추적 항목:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • 모델 이름
Anthropic의 Claude 모델에서 토큰 사용량을 추적하세요.
추적 항목:
  • input_tokensinputTokens
  • output_tokensoutputTokens
  • 계산된 totalTokens
  • 모델 이름
Groq로 초고속 LLM 추론을 추적합니다.
추적 항목:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • 모델 이름
Google GenAI SDK를 통해 Google의 Gemini 모델에서 토큰 사용량을 추적하세요.
추적 항목:
  • promptTokenCountinputTokens
  • candidatesTokenCount + thoughtsTokenCountoutputTokens
  • totalTokenCounttotalTokens
  • 모델 버전
Gemini 생각 모드: Gemini 2.5 Pro 같은 생각/추론 기능이 있는 Gemini 모델을 사용할 때 SDK는 계산 비용을 정확하게 반영하기 위해 outputTokensthoughtsTokenCount(추론 토큰)을 자동으로 포함합니다.

고급 사용법

여러 제공자

별도의 추적기를 사용하여 다양한 LLM 제공자에서 사용량을 추적하세요:
공급자별로 다른 이벤트 이름을 사용하여 미터에서 사용량을 별도로 추적하세요.

Express.js API 통합

Express.js API에 LLM 추적을 통합하는 완전한 예제입니다:

추적되는 항목

모든 LLM API 호출은 다음 구조로 Dodo Payments에 사용량 이벤트를 자동으로 전송합니다:

이벤트 필드

event_id
string
이 특정 이벤트의 고유 식별자입니다. SDK에서 자동으로 생성됩니다.형식: llm_[timestamp]_[random]
customer_id
string
클라이언트를 래핑할 때 제공한 고객 ID입니다. 청구에 사용됩니다.
event_name
string
미터를 트리거하는 이벤트 이름입니다. 트래커 구성과 일치합니다.
timestamp
string
이벤트가 발생한 ISO 8601 타임스탬프입니다.
metadata
object
토큰 사용량 및 추가 추적 데이터입니다:
  • inputTokens - 사용된 입력/프롬프트 토큰 수
  • outputTokens - 사용된 출력/완료 토큰 수(해당하는 경우 추론 토큰 포함)
  • totalTokens - 총 토큰 수(입력 + 출력)
  • model - 사용된 LLM 모델(e.g., “gpt-4”)
  • provider - LLM 공급자(래퍼 메타데이터에 포함된 경우)
  • 클라이언트를 래핑할 때 제공한 사용자 정의 메타데이터
추론 토큰: 추론 기능이 있는 모델의 경우 outputTokens에는 완료 토큰과 추론 토큰이 자동으로 포함됩니다.
Dodo Payments 미터는 사용량 및 청구를 계산하기 위해 metadata 필드(특히 inputTokens, outputTokens 또는 totalTokens)를 사용합니다.

마지막 수정일 2026년 4월 1일