نموذج فوترة OpenAI

​

لماذا يعد نموذج OpenAI هو المعيار

1. إيرادات متوقعة ومخاطر منخفضة: من خلال اشتراط الأرصدة مسبقة الدفع لاستخدام واجهات برمجة التطبيقات، تزيل OpenAI مخاطر تراكم فواتير ضخمة لا يستطيع المستخدمون دفعها. تحصل على المال مقدمًا، ويحصل المستخدم على الخدمة أثناء استخدامه لها.
2. قابلية التوسع للمطورين: شحن بقيمة $5 هو حاجز دخول منخفض. ومع نمو تطبيقاتهم، يمكن للمطورين أتمتة عمليات الشحن أو شراء مجموعات أكبر. الاحتكاك للبدء يكاد يكون معدومًا، لكن سقف النمو لا محدود.
3. سيكولوجية المستخدم: تداول الأرصدة بعملة نقدية (دولار أمريكي) بدلًا من “الرموز” أو “النقاط” المجردة يجعل القيمة واضحة. يبدو الأمر كأنها حساب مصرفي لخدمات الذكاء الاصطناعي، مما يبني الثقة ويُسهل وضع الميزانية للشركات.

​

كيف تقوم OpenAI بالفوترة

1. واجهة برمجة التطبيقات (الدفع عند الاستخدام): تستخدم الواجهة أرصدة مسبقة الدفع مقومة بالعملة النقدية. يُعيد المستخدم شحن حسابه بمبالغ $5 أو $10 أو $50 أو أكثر. تظهر هذه الأرصدة بقيمة الدولار لكنها لا تمتلك قيمة نقدية خارج OpenAI. تقوم OpenAI بالفوترة بناءً على كل رمز، بأسعار مختلفة لرموز الإدخال والإخراج. لا تنتهي صلاحية الأرصدة أبدًا، وعندما يصل رصيد المستخدم إلى $0، تتوقف مكالمات واجهة برمجة التطبيقات فورًا.
2. ChatGPT Plus وTeam وEnterprise: هذه خطط اشتراك بسعر ثابت. تبلغ تكلفة ChatGPT Plus $20 شهريًا، بينما خطة الفريق $25 لكل مستخدم شهريًا. تحتوي هذه الخطط على حدود استخدام ناعمة حيث يتم تخفيض المستخدمين إلى نموذج أصغر بدلًا من الحظر.
3. طبقات الأسعار المعتمدة على الإنفاق: كلما أنفقت المزيد من المال إجماليًا على مر الزمن، تفتح حدود معدلات أعلى لواجهة برمجة التطبيقات. هذا نظام توسيع وصول يعتمد على الثقة ويرتبط مباشرةً بتاريخ فواتيرك.

​

ما الذي يجعله فريدًا

• الأرصدة المُقيمة بالعملة النقدية: تبدو الأرصدة وكأنها نقود لأنها مقيمة بالدولار الأمريكي. هذا يجعل التسعير شفافًا وسهل الفهم للمطورين.
• عدم انتهاء الصلاحية: تزيل الأرصدة التي لا تنتهي أبدًا ضغط “استخدمها أو خسرها”. يشعر المستخدمون بالراحة عند شحن مبالغ أكبر لأنهم يعلمون أن القيمة لن تختفي.
• القياس متعدد الأبعاد: يتم تتبع رموز الإدخال والإخراج بشكل منفصل لكن يتم خصمها من نفس الرصيد. هذا يسمح لـ OpenAI بتسعير رموز الإخراج المكلفة بشكل مختلف عن رموز الإدخال الأرخص.
• طبقات الثقة: ربط حدود المعدل بالإجمالي الذي أنفقته يشجع المستخدمين على البقاء على المنصة ويكافئ العملاء طويل الأمد بأداء أفضل.

​

المزايا الاستراتيجية

​

بناء هذا النموذج باستخدام Dodo Payments

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
});

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_credit_pack_50', quantity: 1 }
  ],
  customer: { email: 'developer@example.com' },
  return_url: 'https://yourapp.com/dashboard'
});

await client.usageEvents.ingest({
  events: [{
    event_id: `req_${requestId}`,
    customer_id: customerId,
    event_name: 'llm.input_tokens',
    timestamp: new Date().toISOString(),
    metadata: {
      model: 'gpt-4o',
      tokens: 1500
    }
  }, {
    event_id: `req_${requestId}_out`,
    customer_id: customerId,
    event_name: 'llm.output_tokens',
    timestamp: new Date().toISOString(),
    metadata: {
      model: 'gpt-4o',
      tokens: 800
    }
  }]
});

async function checkCreditsBeforeRequest(customerId: string) {
  const balance = await client.creditEntitlements.balances.retrieve(customerId, {
    credit_entitlement_id: 'credit_entitlement_id',
  });

  if (balance.available <= 0) {
    throw new Error('Insufficient credits. Please top up your account.');
  }
}

import DodoPayments from 'dodopayments';
import express from 'express';

const app = express();
app.use(express.raw({ type: 'application/json' }));

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
});

app.post('/webhooks/dodo', async (req, res) => {
  try {
    const event = client.webhooks.unwrap(req.body.toString(), {
      headers: {
        'webhook-id': req.headers['webhook-id'] as string,
        'webhook-signature': req.headers['webhook-signature'] as string,
        'webhook-timestamp': req.headers['webhook-timestamp'] as string,
      },
    });

    if (event.type === 'credit.balance_low') {
      const { customer_id, available_balance } = event.data;
      await sendLowBalanceEmail(customer_id, available_balance);
    }

    res.json({ received: true });
  } catch (error) {
    res.status(401).json({ error: 'Invalid signature' });
  }
});

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_plus_subscription', quantity: 1 }
  ],
  customer: { email: 'user@example.com' },
  return_url: 'https://yourapp.com/billing'
});

async function checkSubscriptionUsage(customerId: string) {
  const usage = await getUsageForCurrentPeriod(customerId);
  
  if (usage > SOFT_CAP_THRESHOLD) {
    // Route to a smaller model instead of blocking
    return 'gpt-4o-mini';
  }
  
  return 'gpt-4o';
}

​

سرّع باستخدام مخطط إدخال LLM

npm install @dodopayments/ingestion-blueprints

import { createLLMTracker } from '@dodopayments/ingestion-blueprints';
import OpenAI from 'openai';

const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

const tracker = createLLMTracker({
  apiKey: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'live_mode',
  eventName: 'llm.chat_completion',
});

const trackedClient = tracker.wrap({
  client: openai,
  customerId: customerId,
});

// Every API call now automatically tracks token usage
const response = await trackedClient.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: prompt }],
});

// inputTokens, outputTokens, and totalTokens are sent automatically
console.log('Tokens used:', response.usage);

​

تنفيذ طبقات الأسعار المعتمدة على الإنفاق

1. تتبع الإنفاق طوال الحياة: استمع إلى ويب هوكس payment.succeeded وقم بتحديث حقل total_spend في قاعدة بياناتك لذلك العميل.
2. تعريف الطبقات: أنشئ خريطة تربط مبالغ الإنفاق بحدود المعدل.
   • الطبقة 1: إنفاق $0 - $50 -> 3 طلبات في الدقيقة
   • الطبقة 2: إنفاق $50 - $250 -> 10 طلبات في الدقيقة
   • الطبقة 3: إنفاق $250+ -> 50 طلبًا في الدقيقة
3. فرض الحدود: في طبقة الوسيط لواجهة برمجة التطبيقات، تحقق من طبقة العميل وطبق حد المعدل المقابل.

async function getRateLimitForCustomer(customerId: string) {
  const customer = await db.customers.findUnique({ where: { id: customerId } });
  const totalSpend = customer.total_spend;

  if (totalSpend >= 25000) return TIER_3_LIMITS; // $250.00
  if (totalSpend >= 5000) return TIER_2_LIMITS;  // $50.00
  return TIER_1_LIMITS;
}

​

مثال تنفيذ كامل: الوكيل الخاص بواجهة برمجة التطبيقات

import DodoPayments from 'dodopayments';
import OpenAI from 'openai';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
});
const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

export async function handleApiRequest(req, res) {
  const { customerId, prompt, model } = req.body;

  try {
    // 1. Check credit balance
    const balance = await client.creditEntitlements.balances.retrieve(customerId, {
      credit_entitlement_id: 'credit_entitlement_id',
    });

    if (balance.available <= 0) {
      return res.status(402).json({ error: 'Insufficient credits. Please top up.' });
    }

    // 2. Call OpenAI
    const completion = await openai.chat.completions.create({
      model: model,
      messages: [{ role: 'user', content: prompt }],
    });

    const { prompt_tokens, completion_tokens } = completion.usage;

    // 3. Ingest usage events to Dodo
    await client.usageEvents.ingest({
      events: [
        {
          event_id: `req_${completion.id}_in`,
          customer_id: customerId,
          event_name: 'llm.input_tokens',
          timestamp: new Date().toISOString(),
          metadata: { model, tokens: prompt_tokens }
        },
        {
          event_id: `req_${completion.id}_out`,
          customer_id: customerId,
          event_name: 'llm.output_tokens',
          timestamp: new Date().toISOString(),
          metadata: { model, tokens: completion_tokens }
        }
      ]
    });

    // 4. Return response to user
    res.json(completion);

  } catch (error) {
    console.error('API Error:', error);
    res.status(500).json({ error: 'Internal server error' });
  }
}

​

التعامل مع الحالات الخاصة

​

حالات التنافس

​

تأخر امتصاص الأحداث

​

معالجة الاسترداد

​

دعم النماذج المتعددة

1. عدادات منفصلة: أنشئ عدادات منفصلة لكل نموذج (مثل gpt-4o.input_tokens وgpt-4o-mini.input_tokens).
2. الأحداث الموزونة: استخدم عدادًا واحدًا لكن اضرب القيمة tokens في وزن قبل إرسالها إلى Dodo. على سبيل المثال، إذا كان GPT-4o أغلى بعشرة أضعاف من GPT-4o-mini، يمكنك إرسال 10 أضعاف الرموز لطلبات GPT-4o.

​

نظرة عامة على البنية

​

الخاتمة

​

الميزات الرئيسية في Dodo المستخدمة

​

Race Conditions

​

Event Ingestion Latency

​

Refund Handling

​

Multi-Model Support

1. Separate Meters: Create separate meters for each model (e.g., gpt-4o.input_tokens, gpt-4o-mini.input_tokens).
2. Weighted Events: Use a single meter but multiply the tokens value by a weight before sending it to Dodo. For example, if GPT-4o is 10x more expensive than GPT-4o-mini, you could send 10x the tokens for GPT-4o requests.

​

Architecture Overview

​

Conclusion

​

Key Dodo Features Used