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 등에서 받으세요.
3
Create a Meter in Dodo Payments
사용량을 추적하기 전에 Dodo Payments 대시보드에서 미터를 생성하세요:자세한 지침은 Usage-Based Billing Guide를 참조하세요.
- 로그인 Dodo Payments 대시보드
- 이동 Products → Meters
- 클릭 “Create Meter”
- 미터 구성:
- 미터 이름: 설명적인 이름을 선택하세요 (예: “LLM Token Usage”)
- 이벤트 이름: 고유한 이벤트 식별자를 설정하세요 (예:
llm.chat_completion) - 집계 유형: 토큰 수를 합산하려면
sum을 선택하세요 - 추적 속성: 추적할 항목을 선택하세요:
inputTokens- 입력/프롬프트 토큰 추적outputTokens- 출력/완료 토큰 추적(해당하는 경우 추론 토큰 포함)totalTokens- 입력 + 출력 토큰 총합 추적
여기서 설정한 이벤트 이름은 SDK에 전달하는 값과 정확히 일치해야 합니다(대소문자 구분).
4
Track Token Usage
LLM 클라이언트를 래핑하여 자동으로 추적을 시작하세요:
이제 모든 API 호출이 자동으로 토큰 사용을 추적하고 청구를 위해 Dodo Payments에 이벤트를 전송합니다.
구성
추적기 구성
필수 매개변수로 애플리케이션 시작 시 한 번 추적기를 생성하세요:Dodo Payments API 키입니다. API Keys 페이지에서 가져오세요.
트래커의 환경 모드입니다.
test_mode- 개발 및 테스트용으로 사용live_mode- 운영 환경에서 사용
미터를 트리거하는 이벤트 이름입니다. Dodo Payments 미터에서 구성한 값과 정확히 일치해야 합니다(대소문자 구분).
이 이벤트 이름은 추적된 사용량을 청구 계산을 위한 올바른 미터와 연결합니다.
래퍼 구성
LLM 클라이언트를 래핑할 때 다음 매개변수를 제공하세요:LLM 클라이언트 인스턴스입니다(OpenAI, Anthropic, Groq 등).
청구를 위한 고유 고객 식별자입니다. Dodo Payments에서 사용하는 고객 ID와 일치해야 합니다.
추적 이벤트에 첨부할 선택적 추가 데이터입니다. 필터링 및 분석에 유용합니다.
전체 구성 예제
자동 추적: SDK는 응답을 수정하지 않고 백그라운드에서 토큰 사용량을 자동으로 추적합니다. 코드는 원래 제공자의 SDK를 사용할 때와 동일하게 깔끔하게 유지됩니다.
지원되는 제공자
LLM 블루프린트는 모든 주요 LLM 제공자 및 집계기와 원활하게 작동합니다:AI SDK (Vercel)
AI SDK (Vercel)
범용 LLM 지원을 위해 Vercel AI SDK로 사용량을 추적하세요.추적 항목:
inputTokens→inputTokensoutputTokens+reasoningTokens→outputTokenstotalTokens→totalTokens- 모델 이름
AI SDK(예: 생각 모드가 있는 Google의 Gemini 2.5 Flash)를 통해 추론 기능이 있는 모델을 사용할 때 추론 토큰은 정확한 청구를 위해
outputTokens 계산에 자동으로 포함됩니다.OpenRouter
OpenRouter
OpenRouter의 통합 API를 통해 200개 이상의 모델에서 토큰 사용량을 추적하세요.추적 항목:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- 모델 이름
OpenAI
OpenAI
OpenAI의 GPT 모델에서 토큰 사용량을 자동으로 추적합니다.추적 항목:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- 모델 이름
Anthropic Claude
Anthropic Claude
Anthropic의 Claude 모델에서 토큰 사용량을 추적하세요.추적 항목:
input_tokens→inputTokensoutput_tokens→outputTokens- 계산된
totalTokens - 모델 이름
Groq
Groq
Groq로 초고속 LLM 추론을 추적합니다.추적 항목:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- 모델 이름
Google Gemini
Google Gemini
Google GenAI SDK를 통해 Google의 Gemini 모델에서 토큰 사용량을 추적하세요.추적 항목:
promptTokenCount→inputTokenscandidatesTokenCount+thoughtsTokenCount→outputTokenstotalTokenCount→totalTokens- 모델 버전
Gemini 생각 모드: Gemini 2.5 Pro 같은 생각/추론 기능이 있는 Gemini 모델을 사용할 때 SDK는 계산 비용을 정확하게 반영하기 위해
outputTokens에 thoughtsTokenCount(추론 토큰)을 자동으로 포함합니다.고급 사용법
여러 제공자
별도의 추적기를 사용하여 다양한 LLM 제공자에서 사용량을 추적하세요:Express.js API 통합
Express.js API에 LLM 추적을 통합하는 완전한 예제입니다:추적되는 항목
모든 LLM API 호출은 다음 구조로 Dodo Payments에 사용량 이벤트를 자동으로 전송합니다:이벤트 필드
이 특정 이벤트의 고유 식별자입니다. SDK에서 자동으로 생성됩니다.형식:
llm_[timestamp]_[random]클라이언트를 래핑할 때 제공한 고객 ID입니다. 청구에 사용됩니다.
미터를 트리거하는 이벤트 이름입니다. 트래커 구성과 일치합니다.
이벤트가 발생한 ISO 8601 타임스탬프입니다.
토큰 사용량 및 추가 추적 데이터입니다:
inputTokens- 사용된 입력/프롬프트 토큰 수outputTokens- 사용된 출력/완료 토큰 수(해당하는 경우 추론 토큰 포함)totalTokens- 총 토큰 수(입력 + 출력)model- 사용된 LLM 모델(e.g., “gpt-4”)provider- LLM 공급자(래퍼 메타데이터에 포함된 경우)- 클라이언트를 래핑할 때 제공한 사용자 정의 메타데이터
추론 토큰: 추론 기능이 있는 모델의 경우
outputTokens에는 완료 토큰과 추론 토큰이 자동으로 포함됩니다.Dodo Payments 미터는 사용량 및 청구를 계산하기 위해
metadata 필드(특히 inputTokens, outputTokens 또는 totalTokens)를 사용합니다.