- توليد الصور باستخدام واجهة برمجة التطبيقات DALL-E من OpenAI
- تتبع كل توليد صورة للفواتير
- فرض رسوم على العملاء تلقائيًا بناءً على الاستخدام
- التعامل مع مستويات جودة مختلفة (قياسية مقابل HD)
ما الذي نبنيه
لنبدأ بفهم خدمة PixelGen AI الخاصة بنا:- الخدمة: توليد الصور باستخدام واجهة برمجة التطبيقات DALL-E من OpenAI
- نموذج التسعير: دفع مقابل كل صورة (0.05 دولار لكل صورة)
- الطبقة المجانية: 10 صور مجانية لكل عميل شهريًا
- خيارات الجودة: صور قياسية وHD (نفس السعر للتبسيط)
- حساب Dodo Payments
- الوصول إلى واجهة برمجة تطبيقات OpenAI
- دراية أساسية بـ TypeScript/Node.js
الخطوة 1: إنشاء عداد الاستخدام الخاص بك
سنبدأ بإنشاء عداد في لوحة معلومات Dodo Payments الخاصة بك سيتتبع كل صورة تولدها خدمتنا. اعتبر هذا بمثابة “عداد” يتتبع الأحداث القابلة للفوترة.
Open the Meters section
- سجّل الدخول إلى لوحة تحكم Dodo Payments الخاصة بك
- انقر على Meters في الشريط الجانبي الأيسر
- انقر على زر Create Meter
Fill in the basic meter information
Image Generation MeterDescription: انسخ هذا → Tracks each AI image generation request made by customers using our DALL-E powered serviceEvent Name: هذا أمر حاسم - انسخه تمامًا → image.generatedConfigure how we count images
imagesAdd quality filtering

- Enable Event Filtering: فعّل هذا الخيار ON
- Filter Logic: اختر OR (هذا يعني “احسب إذا كان أي من هذه الشروط صحيحًا”)
- Add the first condition:
- Property Key:
quality - Comparator:
equals - Value:
standard
- Property Key:
- Click “Add Condition” للحالة الثانية:
- Property Key:
quality - Comparator:
equals - Value:
hd
- Property Key:
Create your meter
- تأكد من أن جميع إعداداتك تطابق القيم أعلاه
- انقر على Create Meter
الخطوة 2: إنشاء منتج الفواتير الخاص بك
الآن نحتاج إلى إنشاء منتج يحدد تسعيرنا (0.05 دولار لكل صورة مع 10 صور مجانية). هذا يربط عدادنا بالفواتير الفعلية.Navigate to Products
- في لوحة تحكم Dodo Payments، انقر على Products في الشريط الجانبي الأيسر
- انقر على Create Product
- اختر Usage-Based كنوع المنتج
Enter product details
PixelGen AI - Image GenerationDescription: انسخ هذا → AI-powered image generation service with pay-per-use billingصورة المنتج: قم بتحميل صورة واضحة وذات صلة.Connect your meter

0 لضمان أن العملاء يُفرض عليهم الرسوم بناءً على استخدامهم فقط، دون أي رسوم أساسية.الآن، اربط العداد الذي أنشأته للتو:- قم بالتمرير لأسفل إلى قسم العداد المرتبط
- انقر على إضافة عدادات
- من القائمة المنسدلة، اختر “عداد توليد الصور” (الذي أنشأته سابقًا)
- تأكد من أنه يظهر في تكوين منتجك
Set your pricing

0.05 (هذا 0.05$ لكل صورة)Free Threshold: أدخل → 10 (يحصل العملاء على 10 صور مجانية كل شهر)Save your product
- راجع جميع الإعدادات:
- الاسم: PixelGen AI - Image Generation
- العداد: Image Generation Meter
- السعر: 0.05$ لكل صورة
- المستوى المجاني: 10 صور
- انقر على Save Changes
الخطوة 3: إجراء عملية شراء تجريبية
قبل أن نبدأ في استيعاب أحداث الاستخدام، نحتاج إلى إجراء عملية شراء تجريبية.Get your payment link
- في لوحة تحكم Dodo Payments، اذهب إلى Products
- اعثر على المنتج “PixelGen AI - Image Generation”
- انقر على زر Share بجانب المنتج
- انسخ رابط الدفع الذي يظهر
https://test.checkout.dodopayments.com/buy/pdt_IgPWlRsfpbPd5jQKezzW1?quantity=1Complete a test purchase
- افتح رابط الدفع في علامة تبويب جديدة بالمتصفح
- أدخل بيانات الدفع التجريبية وأكمل عملية الشراء.
Find your customer ID
- ارجع إلى لوحة معلومات Dodo Payments الخاصة بك
- انتقل إلى المبيعات → العملاء في الشريط الجانبي
- ابحث عن العميل الذي أنشأته للتو (مع البريد الإلكتروني التجريبي)
- انسخ معرف العميل - سيبدو مثل
cus_abc123def456
الخطوة 4: بناء التطبيق النموذجي
الآن لدينا إعداد الفواتير مكتمل وعميل تجريبي تم إنشاؤه. دعنا نبني تطبيق PixelGen AI النموذجي الذي يولد الصور ويتتبع الاستخدام تلقائيًا للفواتير.Set up your project
Install dependencies
Create the main application
index.ts ونسخ كود التطبيق الكامل هذا:الخطوة 5: اختبار تطبيقك النموذجي
حان الوقت لاختبار خدمة PixelGen AI النموذجية الخاصة بنا ورؤية الفواتير في العمل! دعنا نتأكد من أن كل شيء يعمل من البداية إلى النهاية.Set up your environment
- أنشئ ملف
.envفي مجلدpixelgen-ai - أضف مفاتيح واجهة برمجة التطبيقات الفعلية الخاصة بك:
- قم بتثبيت التبعيات وتشغيل التطبيق:
Generate your first test image
Generate a few more images
- “غروب الشمس فوق الجبال مع سحب بنفسجية”
- “آلة قهوة ستيمبانك في مطبخ فيكتوري”
- “تنين ودود يقرأ كتابًا في مكتبة”
Check your Dodo Payments dashboard
- افتح لوحة معلومات Dodo Payments الخاصة بك
- انتقل إلى الفواتير القائمة على الاستخدام → *عدادات → عداد توليد الصور
- انقر على علامة التبويب الأحداث
- يجب أن ترى أحداث توليد الصور الخاصة بك مدرجة
- أسماء الأحداث:
image.generated - معرف العميل: معرف العميل التجريبي الخاص بك
Verify billing calculations

- في عدادك، انتقل إلى علامة التبويب العملاء
- ابحث عن عميلك التجريبي
- تحقق من عمود “الوحدات المستهلكة”
Test the billing threshold
- قم بتوليد 8 صور أخرى (للوصول إلى 12 إجماليًا)
- تحقق من لوحة عدادك مرة أخرى
- يجب أن ترى الآن:
- الوحدات المستهلكة: 12
- الوحدات القابلة للفوترة: 2 (12 - 10 مجانية)
- مبلغ الفواتير: 0.10 دولار
استكشاف الأخطاء وإصلاحها
المشاكل الشائعة وحلولها:Events not appearing in dashboard
Events not appearing in dashboard
- لا يتطابق اسم الحدث مع تكوين العداد تمامًا
- معرف العميل غير موجود في حسابك
- مفتاح واجهة البرمجة غير صالح أو منتهي
- مشاكل في الاتصال بالشبكة
- تحقق من تطابق اسم الحدث مع تكوين العداد تمامًا (حساس لحالة الأحرف)
- تأكد من وجود معرف العميل في Dodo Payments
- اختبر مفتاح واجهة البرمجة باستدعاء بسيط
- تحقق من الاتصال بالشبكة وإعدادات الجدار الناري