이 튜토리얼은 백엔드와 프론트엔드 모두를 포함한 완전한 작동 애플리케이션을 제공합니다. 채팅 앱은 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 토큰 사용량을 추적할 미터기를 생성하는 것부터 시작하겠습니다.미터기 섹션 열기
- Dodo Payments 대시보드에 로그인합니다.
- 왼쪽 사이드바에서 제품을 클릭합니다.
- 미터기를 클릭합니다.
- 미터기 생성 버튼을 클릭합니다.

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

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

미터는 모든
totalTokens 값을 자동으로 합산하고 있습니다!문제 해결
일반적인 문제와 그 해결 방법:대시보드에 이벤트가 나타나지 않음
대시보드에 이벤트가 나타나지 않음
가능한 원인:
- 이벤트 이름이 미터기 구성과 정확히 일치하지 않음
- 고객 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파일에서 키 주위의 따옴표를 제거합니다.- 필요시 새 키를 생성합니다.

