Skip to main content
अपने coding agent से integration लिखवाने के लिए Dodo Agent Plugin install करें। यह Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro और OpenCode में Dodo Payments skills और MCP servers जोड़ता है।
आप PixelGen AI बनाएंगे, जो एक sample AI image generation service है और usage-based billing के साथ customers से प्रति image शुल्क लेती है। आप billing meter और product बनाएंगे, साथ ही sample application code लिखेंगे जो images generate करता है और हर image बनने पर उसे Dodo Payments को report करता है।
यह tutorial एक terminal application के लिए sample code देता है। आप इस code को React, Vue या Angular जैसे framework के अनुसार और अपने application द्वारा user input एकत्र करने के तरीके के अनुसार बदल सकते हैं।
पूरा करने पर, आपके पास एक कार्यशील नमूना सेवा होगी जो:
  • OpenAI के gpt-image-2.5-flare मॉडल से इमेज जनरेट करती है।
  • बिलिंग के लिए हर इमेज जनरेशन को ट्रैक करती है।
  • ग्राहकों द्वारा जनरेट की गई इमेज के लिए उनसे शुल्क लेती है।
  • दो गुणवत्ता स्तरों, medium और high, को संभालती है।

हम क्या बनाएंगे

PixelGen AI इस तरह काम करता है:
  • सेवा: OpenAI Image API के साथ AI इमेज जनरेशन
  • प्राइसिंग मॉडल: प्रति इमेज भुगतान ($0.05 प्रति इमेज)
  • निःशुल्क स्तर: प्रति ग्राहक प्रति माह 10 निःशुल्क इमेज
  • गुणवत्ता विकल्प: समान कीमत पर medium और high गुणवत्ता वाली इमेज
शुरू करने से पहले, आपके पास ये होना चाहिए:
  • Dodo Payments खाता।
  • OpenAI API का एक्सेस। GPT Image मॉडल का उपयोग करने से पहले OpenAI को API Organization Verification की आवश्यकता हो सकती है।
  • Node.js 22 या बाद का संस्करण, और TypeScript तथा Node.js का कार्यसाधक ज्ञान।

Step 1: अपना Usage Meter बनाएं

Dodo Payments dashboard में एक meter बनाएं जो service द्वारा generate की जाने वाली हर image को track करे। Meter billable events की गिनती करता है।
Create Meter form in the Dodo Payments dashboard
आप क्या बना रहे हैं: “Image Generation Meter” नाम का meter, जो हर image generation की गिनती करता है।
1

Open the Meters Section

  1. Dodo Payments dashboard में log in करें।
  2. Sidebar में Products → Meters पर जाएं।
  3. Create Meter पर click करें।
Meter form खुलता है।
2

Enter the Meter Details

PixelGen AI के लिए विवरण दर्ज करें:Meter Name: Image Generation Meterविवरण: Tracks each AI image generation request made by customers using our OpenAI image serviceEvent Name: image.generated
Event name image.generated application code द्वारा भेजे जाने वाले event name से match होना चाहिए। Event names case-sensitive होते हैं।
3

Configure How Images Are Counted

Aggregation सेट करें, जो यह नियंत्रित करता है कि meter events को कैसे combine करता है:Aggregation Type: CountMeasurement Unit: images
Count size या generation time के आधार पर नहीं, बल्कि generate की गई images की संख्या के आधार पर billing करता है। हर सफल image एक billable unit है।
4

Add Quality Filtering

Event filtering on the meter form with two quality conditions joined by OR
केवल वास्तविक images की गिनती करें, test runs या malformed events की नहीं:
  1. Enable Event Filtering चालू करें।
  2. मिलान लॉजिक को OR पर सेट करें, ताकि कोई भी शर्त पूरी होने पर इवेंट की गणना हो।
  3. पहली शर्त जोड़ें:
    • Key: quality
    • Operator: equals
    • Value: medium
  4. Add condition पर क्लिक करें और दूसरी शर्त जोड़ें:
    • Key: quality
    • Operator: equals
    • Value: high
इस फ़िल्टर के साथ, मीटर केवल उन इवेंट की गणना करता है जिनकी गुणवत्ता medium या high है, और टेस्ट या गलत फ़ॉर्मैट वाले इवेंट को अनदेखा करता है।
5

Create Your Meter

  1. जांचें कि हर setting ऊपर दिए गए values से match करती है। Meter बनाने के बाद आप उसे edit नहीं कर सकते।
  2. Create Meter पर click करें।
Meter बनाया गया। “Image Generation Meter” अब image generations की गिनती के लिए तैयार है। अगला चरण इसे billing product से connect करना है।

Step 2: अपना Billing Product बनाएं

एक ऐसा product बनाएं जो pricing निर्धारित करे: प्रति image $0.05, जिसमें 10 free images हों। Product meter को billing से connect करता है।
आप क्या बना रहे हैं: “PixelGen AI - Image Generation” नाम का product, जो हर month पहली 10 free images के बाद प्रति image $0.05 charge करता है।
1

Navigate to Products

  1. Dodo Payments dashboard में sidebar से Products पर click करें।
  2. Add Product पर click करें।
  3. Pricing Type के अंतर्गत Usage Based Billing चुनें।
इस pricing type के साथ Dodo Payments fixed subscription price के बजाय meter usage के आधार पर billing करता है।
2

Enter Product Details

ये values दर्ज करें:Product Name: PixelGen AI - Image GenerationDescription: AI-powered image generation service with pay-per-use billingProduct Image: स्पष्ट और relevant image upload करें।
Name और description customer invoices पर दिखाई देते हैं।
3

Connect Your Meter

Usage Based Billing pricing on the product form with the Associated Meters section
जांचें कि product का pricing type Usage Based Billing है।Price को 0 पर सेट करें, ताकि customers केवल usage के लिए भुगतान करें और कोई base fee न हो।फिर आपके द्वारा बनाए गए meter को link करें:
  1. Associated Meters section तक scroll करें।
  2. Add meters पर click करें।
  3. Dropdown से “Image Generation Meter” चुनें।
  4. Confirm करें कि meter product configuration में दिखाई दे रहा है।
Meter product से connect हो गया है।
4

Set Your Pricing

प्रति-image price और free tier निर्धारित करें:
Meter pricing with price per unit and free threshold fields
Price per unit: 0.05, यानी प्रति image $0.05।Free Threshold: 10। हर customer को प्रति month 10 free images मिलती हैं।
Billing कैसे काम करती है: जो customer एक month में 25 images generate करता है, वह 15 images के लिए भुगतान करता है (25 − 10 free)। 15 × $0.05 = $0.75।
5

Save Your Product

  1. Settings की समीक्षा करें:
    • Name: PixelGen AI - Image Generation
    • Meter: Image Generation Meter
    • Price: $0.05 प्रति image
    • Free tier: 10 images
  2. Save Changes पर click करें।
Product बनाया गया। Billing configure हो गई है और customers द्वारा generate की गई images के लिए उनसे charge लिया जाता है।

Step 3: Test Purchase करें

Test mode में product को एक बार खरीदें। Purchase वह customer बनाता है जिसके लिए app usage events भेजता है।
1

Get Your Payment Link

  1. Dodo Payments dashboard में Products पर जाएं।
  2. “PixelGen AI - Image Generation” product खोजें।
  3. Product के पास Share पर click करें।
  4. Payment link copy करें।
Payment link https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1 जैसा दिखता है।
2

Complete a Test Purchase

  1. Payment link को नए browser tab में खोलें।
  2. test payment details दर्ज करें और purchase पूरा करें।
Payment सफल होने के बाद purchase एक customer बनाता है। Application code उस customer की ID का उपयोग करता है।
3

Find Your Customer ID

  1. Dodo Payments dashboard पर वापस जाएं।
  2. Sidebar में Sales → Customers पर जाएं।
  3. अपने बनाए customer को उसके test email address से खोजें।
  4. Customer ID copy करें। यह cus_abc123def456 जैसी दिखती है।
इस customer ID को save करें। Sample application इसे code में set करता है, इसलिए हर event इसी customer के लिए record होता है।

Step 4: Sample Application बनाएं

Billing setup और test customer बनाने के बाद sample PixelGen AI application बनाएं। यह एक image generate करता है और billing के लिए उसे Dodo Payments को report करता है।
नमूना Image API के ज़रिए OpenAI के gpt-image-2.5-flare मॉडल को कॉल करता है। Image API base64-encoded इमेज डेटा लौटाता है, इसलिए नमूना हर इमेज को PNG फ़ाइल के रूप में सेव करता है। Dodo Payments वाला हिस्सा (मीटर, प्रोडक्ट और image.generated usage event) मॉडल पर निर्भर नहीं करता।
1

Set Up Your Project

एक directory बनाएं और project initialize करें:
2

Install Dependencies

Packages install करें:
3

Create the Main Application

index.ts नाम की file बनाएं और नीचे दिया application code उसमें paste करें।
Billing सहित पूरा PixelGen AI application, साथ में matching .env और package.json:

Step 5: Sample Application का Test करें

PixelGen AI का end-to-end test करें और usage को Dodo Payments तक पहुंचते हुए देखें।
आप क्या test कर रहे हैं: आप कुछ images generate करेंगे, confirm करेंगे कि events Dodo Payments तक पहुंचते हैं, और billing calculation जांचेंगे।
1

Set Up Your Environment

  1. pixelgen-ai directory में .env file बनाएं।
  2. अपनी API keys जोड़ें:
  1. Dependencies install करें और app चलाएं:
Real API keys का उपयोग करें और index.ts में hardcoded customer ID को Step 3 वाली customer ID से replace करें।
2

Generate Your First Test Image

App शुरू होने पर यह print करता है:
यह prompt दर्ज करें: “A cute robot painting a landscape”Output इस तरह दिखता है। sendUsageEvent द्वारा print की जाने वाली request debug lines शामिल नहीं हैं:
यदि output में “Usage event sent successfully” शामिल है, तो billing integration काम कर रहा है।
3

Generate a Few More Images

Multiple events test करने के लिए दो या तीन और images generate करें। हर image के लिए npm start एक बार चलाएं और ये prompts इस्तेमाल करें:
  1. “A sunset over mountains with purple clouds”
  2. “A steampunk coffee machine in a Victorian kitchen”
  3. “A friendly dragon reading a book in a library”
हर बार “Usage event sent successfully” message की जांच करें।
4

Check Your Dodo Payments Dashboard

Confirm करें कि Dodo Payments को events मिल रहे हैं:
  1. Dodo Payments dashboard खोलें।
  2. Products → Meters पर जाएं और Image Generation Meter खोलें।
  3. Events tab चुनें।
  4. List में अपने image generation events खोजें।
क्या देखें:
  • Event name: image.generated
  • Customer ID: आपका test customer ID
List में आपके द्वारा generate की गई हर image के लिए एक event होता है।
5

Verify Billing Calculations

Usage count जांचें:
Customers tab of the meter showing consumed units per customer
  1. Meter में Customers tab चुनें।
  2. अपना test customer खोजें।
  3. Consumed Units column जांचें।
6

Test the Billing Threshold

Billing देखने के लिए free tier से आगे जाएं:
  1. कुल 12 images के लिए 8 और images generate करें।
  2. Meter का Customers tab फिर खोलें।
  3. Values जांचें:
    • Consumed Units: 12
    • Chargeable Units: 2 (12 − 10 free)
    • Total Price: $0.10
Usage-based billing काम कर रही है। Customers द्वारा generate की गई images के लिए उनसे charge लिया जाता है।

Troubleshooting

सामान्य समस्याएं और उनके समाधान:
संभावित कारण:
  • Event name meter configuration से exact match नहीं करता
  • Customer ID आपके account में मौजूद नहीं है
  • API key invalid या expired है
  • Network connectivity issues
समाधान:
  1. जांचें कि event name meter से exact match करता है। यह case-sensitive है।
  2. जांचें कि customer ID Dodo Payments में मौजूद है।
  3. एक simple API call के साथ API key test करें।
  4. Network connectivity और firewall settings जांचें।

बधाई हो! आपने PixelGen AI बनाया

आपने usage-based billing वाला एक sample AI image generator बनाया है:

Usage Meter

एक “Image Generation Meter” जो हर image generation event की गिनती करता है।

Billing Product

प्रति image $0.05 की pricing, जिसमें प्रति month 10 free images हैं।

AI Application

एक TypeScript app जो OpenAI image API से images generate करता है।

Automated Billing

Event tracking जो हर image generate होते ही उसे report करती है, ताकि customers से usage के आधार पर billing की जा सके।
अंतिम संशोधन 26 सितंबर 2026