이 튜토리얼은 백엔드와 프론트엔드 모두를 포함한 완전한 작동 애플리케이션을 제공합니다. 채팅 앱은 Google의 Gemini AI를 사용하며 수동 계산 없이 자동으로 토큰 사용량을 추적합니다.
- Google Gemini(AI SDK)를 사용하여 AI 대화 지원
- 자동으로 토큰 사용량 추적(수동 코드 없음)
- 실제 토큰 소비에 따라 고객에게 요금 청구
- 아름다운 채팅 인터페이스 포함

우리가 구축할 내용
AI 채팅 서비스를 이해하는 것부터 시작해봅시다:- 서비스: Google Gemini(AI SDK)를 사용하는 AI 기반 채팅
- 가격 모델: 토큰당 요금($0.01 per 1,000 tokens)
- 무료 티어: 고객당 월 10,000개의 무료 토큰
- 기능: 대화 기록, 자동 토큰 추적
시작하기 전에 다음을 확인하세요:
- Dodo Payments 계정
- Google AI API 키 (aistudio에서 가져오기)
- Node.js v16+ 설치
1단계: 사용량 미터기 생성하기
Dodo Payments 대시보드에서 AI 토큰 사용량을 추적할 미터기를 생성하는 것부터 시작하겠습니다.1
미터기 섹션 열기
- Dodo Payments 대시보드에 로그인합니다.
- 왼쪽 사이드바에서 제품을 클릭합니다.
- 미터기를 클릭합니다.
- 미터기 생성 버튼을 클릭합니다.

2
기본 미터기 정보 입력하기
이제 AI 채팅 서비스에 대한 구체적인 세부정보를 입력하겠습니다:미터기 이름 →
AI Token Usage Meter설명 → Tracks token consumption from AI chat conversations using AI SDK이벤트 이름 → ai_chat_usage3
토큰 계산 방법 구성하기
집계 설정(미터기가 이벤트를 계산하는 방법):집계 유형: 드롭다운에서 합계를 선택합니다.집계 기준: 입력 →
totalTokens측정 단위: 입력 → tokens우리는 “합계”를 사용하고 있습니다. 왜냐하면 여러 채팅 메시지에서 소비된 모든 토큰을 합산하고 싶기 때문입니다. SDK는 각 이벤트에서
totalTokens를 자동으로 보냅니다.4
미터기 생성하기
- 모든 설정이 위의 값과 일치하는지 다시 확인합니다.
- 미터기 생성을 클릭합니다.

미터기 생성 완료! “AI 토큰 사용량 미터기”가 이제 토큰을 계산할 준비가 되었습니다. 다음으로 청구 제품에 연결하겠습니다.
2단계: API 키 가져오기
앱을 구축하기 전에 필요한 API 키를 모아봅시다.1
Dodo Payments API 키 가져오기
- Dodo Payments 대시보드에서 개발자 → API 키로 이동합니다.
- API 키 생성을 클릭합니다.
- API 키를 복사합니다 -
test_abc123...와 같은 형식입니다.
이 API 키를 저장하세요 - 나중에
.env 파일에 추가할 것입니다.2
Google AI API 키 가져오기
- aistudio.google.com 방문
- API 키 가져오기를 클릭합니다.
- 새 API 키를 생성하거나 기존 키를 사용합니다.
- 키를 복사합니다.
이 키를 안전하게 보관하세요 - 나중에
.env 파일에 추가할 것입니다.3단계: 청구 제품 생성하기
이제 가격($0.01 per 1,000 tokens 및 10,000개의 무료 토큰)을 정의하는 제품을 생성해야 합니다. 이는 미터기를 실제 청구에 연결합니다.1
제품으로 이동하기
- Dodo Payments 대시보드에서 왼쪽 사이드바의 제품을 클릭합니다.
- 제품 생성을 클릭합니다.
- 제품 유형으로 사용 기반을 선택합니다.
2
제품 세부정보 입력하기
필수 세부정보를 입력합니다:제품 이름: →
AI Chat Service설명: → AI-powered chat service with automatic token-based billing제품 이미지: 관련 이미지를 업로드합니다.이것들은 고객 청구서에 나타나므로 명확하고 전문적으로 만들어야 합니다.
3
미터기 연결하기
미터기를 연결하기 전에 제품의 가격 유형으로 사용 기반 청구를 선택했는지 확인하세요.또한, 고객이 사용량에 따라 요금만 부과되도록 고정 가격을
0로 설정합니다. 기본 요금은 없습니다.이제 방금 생성한 미터기를 연결합니다:- 연결된 미터기 섹션으로 스크롤합니다.
- 미터기 추가를 클릭합니다.
- 드롭다운에서 “AI 토큰 사용량 미터기”(이전에 생성한 것)를 선택합니다.
- 제품 구성에 나타나는지 확인합니다.
미터기가 이제 이 제품에 성공적으로 연결되었습니다.
4
가격 설정하기
여기서 비즈니스 모델을 정의합니다:단위당 가격: 입력 → 
0.00001 (이는 0.00001 per token입니다)무료 한도: 입력 → 10000 (고객은 월 10,000개의 무료 토큰을 받습니다)
5
제품 저장하기
- 모든 설정을 검토합니다:
- 이름: AI 채팅 서비스
- 미터기: AI 토큰 사용량 미터기
- 가격: $0.01 per 1,000 tokens
- 무료 티어: 10,000 tokens
- 변경 사항 저장을 클릭합니다.
제품 생성 완료! 이제 청구가 구성되었습니다. 고객은 자동으로 토큰 사용량에 따라 요금이 청구됩니다.
4단계: 테스트 구매하기
앱을 구축하기 전에 구매를 통해 테스트 고객을 생성해봅시다.1
결제 링크 가져오기
- Dodo Payments 대시보드에서 제품으로 이동합니다.
- “AI 채팅 서비스” 제품을 찾습니다.
- 제품 옆의 공유 버튼을 클릭합니다.
- 나타나는 결제 링크를 복사합니다.
2
테스트 구매 완료하기
- 새 브라우저 탭에서 결제 링크를 엽니다.
- 테스트 결제 세부정보를 입력하고 구매를 완료합니다.
결제가 성공적으로 완료되면 애플리케이션 코드에서 사용할 고객 ID를 얻게 됩니다.
3
고객 ID 찾기
- Dodo Payments 대시보드로 돌아갑니다.
- 왼쪽 사이드바에서 판매 -> 고객으로 이동합니다.
- 방금 생성한 고객(테스트 이메일로)을 찾습니다.
- 고객 ID를 복사합니다 -
cus_123와 같은 형식입니다.
이 고객 ID를 저장하세요 - 채팅 애플리케이션을 테스트할 때 사용할 것입니다.
5단계: 채팅 애플리케이션 구축하기
이제 청구 설정이 완료되고 테스트 고객이 생성되었습니다. 자동 토큰 추적 기능을 갖춘 AI 채팅 애플리케이션을 구축해봅시다.1
프로젝트 설정하기
새 디렉토리를 만들고 프로젝트를 초기화합니다:
2
의존성 설치하기
필요한 패키지를 설치합니다:
3
TypeScript 구성하기
tsconfig.json를 생성합니다:tsconfig.json
package.json를 업데이트하여 모듈 유형 및 스크립트를 추가합니다:package.json
4
프로젝트 구조 생성하기
폴더와 파일을 생성합니다:
5
환경 변수 설정하기
프로젝트 루트에 자리 표시자 값을 2단계에서 가져온 실제 API 키로 교체합니다.
.env 파일을 생성합니다:.env
6
백엔드 서버 생성하기
src/server.ts를 생성하고 이 전체 서버 코드를 복사합니다:6단계: 채팅 인터페이스 추가하기
이제 전체 대화 기록이 포함된 아름다운 채팅 인터페이스를 추가해봅시다!public/index.html를 생성합니다:
public/index.html
7단계: 채팅 애플리케이션 테스트하기
이제 AI 채팅 앱을 테스트하고 청구가 작동하는지 확인해봅시다! 모든 것이 끝에서 끝까지 작동하는지 확인해봅시다.1
서버 시작하기
먼저 모든 것이 설정되었는지 확인합니다:다음과 같은 메시지가 표시되어야 합니다:
.env파일에 2단계에서 가져온 모든 API 키가 있는지 확인합니다.- 개발 서버를 시작합니다:
서버가 실행 중입니다! 이제 채팅을 시작해봅시다.
2
채팅 인터페이스 열기
- 브라우저를 엽니다.
http://localhost:3000로 이동합니다.- 아름다운 채팅 인터페이스가 표시되어야 합니다.
server.ts에서 실제 테스트 고객 ID로 CUSTOMER_ID를 업데이트했는지 확인하세요.3
첫 번째 대화 나누기
테스트해봅시다! 다음 메시지를 시도해보세요:
- “인공지능이란 무엇인가요?”
- “기계 학습은 어떻게 작동하나요?”
- “신경망을 설명해 주실 수 있나요?”
AI가 응답하고 토큰 수가 나타나면 앱이 작동하고 있는 것입니다!
4
Dodo Payments 대시보드 확인하기
이제 이벤트가 수신되고 있는지 확인해봅시다:
- Dodo Payments 대시보드를 엽니다.
- 사용 청구 → AI 토큰 사용량 미터기로 이동합니다.
- 이벤트 탭을 클릭합니다.
- 채팅 이벤트가 나열되어야 합니다.
- 이벤트 이름:
ai_chat_usage - 고객 ID: 테스트 고객 ID

보낸 각 메시지에 대해 하나의 이벤트가 표시되어야 합니다!
5
토큰 계산 확인하기
더 많은 메시지를 보내고 토큰 집계가 작동하는지 확인해봅시다:
- 미터기에서 고객 탭으로 이동합니다.
- 테스트 고객을 찾습니다.
- “소비된 단위” 열을 확인합니다 - 사용된 총 토큰 수가 표시되어야 합니다.

미터기가 모든
totalTokens 값을 자동으로 합산하고 있습니다!6
무료 티어 테스트하기
무료 티어를 초과할 만큼 충분한 토큰을 사용해봅시다:
- 여러 번 대화를 나눕니다(약 15,000개 이상의 총 토큰 목표)
- 미터기 대시보드에서 고객 탭을 다시 확인합니다.
- 이제 다음과 같은 내용이 표시되어야 합니다:
- 소비된 단위: 15,000개 이상의 토큰
- 청구 가능한 단위: 5,000개 (10,000개의 무료 토큰 적용)
- 총 가격: ~$0.05

성공! 사용 기반 청구가 완벽하게 작동하고 있습니다. 고객은 실제 토큰 소비에 따라 자동으로 요금이 청구됩니다.
문제 해결
일반적인 문제와 그 해결 방법:대시보드에 이벤트가 나타나지 않음
대시보드에 이벤트가 나타나지 않음
가능한 원인:
- 이벤트 이름이 미터기 구성과 정확히 일치하지 않음
- 고객 ID가 계정에 존재하지 않음
- API 키가 유효하지 않거나 만료됨
- 네트워크 연결 문제
- 이벤트 이름이 미터기 구성과 정확히 일치하는지 확인합니다(대소문자 구분:
ai_chat_usage) - 고객 ID가 Dodo Payments 대시보드에 존재하는지 확인합니다.
- 간단한 API 호출로 API 키를 테스트합니다.
- 서버 로그에서 오류 메시지를 확인합니다.
토큰 수가 0으로 표시됨
토큰 수가 0으로 표시됨
가능한 원인:
- 모델이 사용 정보를 반환하지 않음
- 잘못된 SDK 버전
- 모델이 사용량을 반환하는지 테스트합니다:
- 최신 Blueprints SDK로 업데이트합니다:
npm install @dodopayments/ingestion-blueprints@latest
API 키 유효하지 않음 오류
API 키 유효하지 않음 오류
가능한 원인:
- 환경에 대한 잘못된 API 키
.env파일에 여분의 공백 또는 따옴표가 있음
- 테스트 키가
test_로 시작하고, 라이브 키가live_로 시작하는지 확인합니다. .env파일에서 키 주위의 따옴표를 제거합니다.- 필요시 새 키를 생성합니다.