- تنشئ صورًا باستخدام نموذج OpenAI
gpt-image-2.5-flare. - تتتبّع كل عملية إنشاء صورة لأغراض الفوترة.
- تفرض رسومًا على العملاء مقابل الصور التي ينشئونها.
- تتعامل مع مستويي الجودة
mediumوhigh.
ما الذي سنبنيه
تعمل PixelGen AI على النحو التالي:- الخدمة: إنشاء صور بالذكاء الاصطناعي باستخدام OpenAI Image API
- نموذج التسعير: الدفع مقابل كل صورة ($0.05 لكل صورة)
- الخطة المجانية: 10 صور مجانية لكل عميل شهريًا
- خيارات الجودة: صور بجودة
mediumوhighبالسعر نفسه
- حساب Dodo Payments.
- الوصول إلى OpenAI API. قد تتطلب OpenAI التحقق من مؤسسة API قبل استخدام نماذج GPT Image.
- Node.js 22 أو إصدار أحدث، ومعرفة عملية بـ TypeScript وNode.js.
الخطوة 1: إنشاء Usage Meter
أنشئ meter في لوحة تحكم Dodo Payments يتتبّع كل صورة تولّدها الخدمة. يحسب meter الأحداث القابلة للفوترة.
Open the Meters Section
- سجّل الدخول إلى لوحة تحكم Dodo Payments.
- انتقل إلى Products → Meters في الشريط الجانبي.
- انقر على Create Meter.
Enter the Meter Details
Image Generation Meterالوصف: Tracks each AI image generation request made by customers using our OpenAI image serviceEvent Name: image.generatedConfigure How Images Are Counted
imagesAdd Quality Filtering

- فعّل Enable Event Filtering.
- اضبط منطق المطابقة على OR، بحيث يُحتسب الحدث عند تطابق أي شرط.
- أضف الشرط الأول:
- المفتاح:
quality - العامل:
equals - القيمة:
medium
- المفتاح:
- انقر على Add condition وأضف الشرط الثاني:
- المفتاح:
quality - العامل:
equals - القيمة:
high
- المفتاح:
Create Your Meter
- تحقّق من أن كل إعداد يطابق القيم السابقة. لا يمكنك تعديل meter بعد إنشائه.
- انقر على Create Meter.
الخطوة 2: إنشاء منتج الفوترة
أنشئ منتجًا يحدد التسعير: $0.05 لكل صورة، مع 10 صور مجانية. يصل المنتج meter بالفوترة.Navigate to Products
- في لوحة تحكم Dodo Payments، انقر على Products في الشريط الجانبي.
- انقر على Add Product.
- ضمن Pricing Type، حدّد Usage Based Billing.
Enter Product Details
PixelGen AI - Image GenerationDescription: AI-powered image generation service with pay-per-use billingProduct Image: حمّل صورة واضحة وملائمة.Connect Your Meter

0، بحيث يدفع العملاء مقابل الاستخدام فقط، من دون رسوم أساسية.بعد ذلك، اربط meter الذي أنشأته:- مرّر إلى قسم Associated Meters.
- انقر على Add meters.
- حدّد “Image Generation Meter” من القائمة المنسدلة.
- تأكّد من ظهور meter في إعدادات المنتج.
Set Your Pricing

0.05، أي $0.05 لكل صورة.Free Threshold: 10. يحصل كل عميل على 10 صور مجانية شهريًا.Save Your Product
- راجع الإعدادات:
- Name: PixelGen AI - Image Generation
- Meter: Image Generation Meter
- Price: $0.05 per image
- Free tier: 10 images
- انقر على Save Changes.
الخطوة 3: إجراء عملية شراء اختبارية
اشترِ المنتج مرة واحدة في test mode. تنشئ عملية الشراء العميل الذي يرسل التطبيق أحداث الاستخدام الخاصة به.Get Your Payment Link
- في لوحة تحكم Dodo Payments، انتقل إلى Products.
- ابحث عن المنتج “PixelGen AI - Image Generation”.
- انقر على Share بجانب المنتج.
- انسخ رابط الدفع.
https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1.Complete a Test Purchase
- افتح رابط الدفع في علامة تبويب جديدة في المتصفح.
- أدخل تفاصيل الدفع الاختبارية وأكمل عملية الشراء.
Find Your Customer ID
- عُد إلى لوحة تحكم Dodo Payments.
- انتقل إلى Sales → Customers في الشريط الجانبي.
- ابحث عن العميل الذي أنشأته باستخدام عنوان بريده الإلكتروني الاختباري.
- انسخ معرّف العميل. يبدو على النحو التالي
cus_abc123def456.
الخطوة 4: بناء التطبيق النموذجي
بعد إعداد الفوترة وإنشاء عميل اختباري، ابنِ تطبيق PixelGen AI النموذجي. فهو يولّد صورة ويرسل تقريرًا بها إلى Dodo Payments لأغراض الفوترة.gpt-image-2.5-flare من خلال Image API. يعيد Image API بيانات الصور بترميز base64، لذلك يحفظ المثال كل صورة كملف PNG. ولا يعتمد جزء Dodo Payments (العداد والمنتج وحدث الاستخدام image.generated) على النموذج.Set Up Your Project
Install Dependencies
Create the Main Application
index.ts والصق فيه شفرة التطبيق أدناه..env وpackage.json المطابقين:
الخطوة 5: اختبار التطبيق النموذجي
اختبر PixelGen AI من البداية إلى النهاية وراقب وصول الاستخدام إلى Dodo Payments.Set Up Your Environment
- أنشئ ملف
.envفي directorypixelgen-ai. - أضف مفاتيح API الخاصة بك:
- ثبّت dependencies وشغّل التطبيق:
Generate Your First Test Image
sendUsageEvent:Generate a Few More Images
npm start مرة واحدة لكل صورة، باستخدام prompts التالية:- “غروب فوق جبال مع سحب بنفسجية”
- “آلة قهوة تعمل بالبخار في مطبخ من العصر الفيكتوري”
- “تنين ودود يقرأ كتابًا في مكتبة”
Check Your Dodo Payments Dashboard
- افتح لوحة تحكم Dodo Payments.
- انتقل إلى Products → Meters وافتح Image Generation Meter.
- حدّد علامة التبويب Events.
- ابحث عن أحداث توليد الصور في القائمة.
- Event name:
image.generated - Customer ID: معرّف العميل الاختباري الخاص بك
Verify Billing Calculations

- في meter، حدّد علامة التبويب Customers.
- ابحث عن عميلك الاختباري.
- تحقّق من عمود Consumed Units.
Test the Billing Threshold
- ولّد 8 صور إضافية، ليصبح المجموع 12 صورة.
- افتح علامة التبويب Customers الخاصة بـ meter مرة أخرى.
- تحقّق من القيم:
- Consumed Units: 12
- Chargeable Units: 2 (12 − 10 مجانية)
- Total Price: $0.10
استكشاف الأخطاء وإصلاحها
المشكلات الشائعة وحلولها:Events not appearing in dashboard
Events not appearing in dashboard
- لا يطابق اسم الحدث إعداد meter تمامًا
- معرّف العميل غير موجود في حسابك
- مفتاح API غير صالح أو منتهي الصلاحية
- مشكلات في الاتصال بالشبكة
- تحقّق من تطابق اسم الحدث مع meter تمامًا. فهو حساس لحالة الأحرف.
- تحقّق من وجود معرّف العميل في Dodo Payments.
- اختبر مفتاح API باستخدام استدعاء API بسيط.
- تحقّق من اتصال الشبكة وإعدادات جدار الحماية.