OpenAI Billing Model

​

Why OpenAI’s Model is the Standard

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

​

How OpenAI Bills

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

​

ما الذي يميّزها

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

​

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

​

أنشئ هذا باستخدام 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: 'pdt_credit_pack_50', quantity: 1 }
  ],
  customer: { email: 'developer@example.com' },
  return_url: 'https://yourapp.com/dashboard'
});

// requestId and customerId come from your application's request context.
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: 'cde_your_credit_entitlement_id',
  });

  if (Number(balance.balance) <= 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,
});

// sendLowBalanceEmail is your application's own function.
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: 'pdt_plus_subscription', quantity: 1 }
  ],
  customer: { email: 'user@example.com' },
  return_url: 'https://yourapp.com/billing'
});

// getUsageForCurrentPeriod and SOFT_CAP_THRESHOLD are defined in your application.
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 Ingestion Blueprint

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',
});

// customerId and prompt come from your application.
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. تتبّع إجمالي الإنفاق: استمع إلى Webhooks ‏payment.succeeded وأضف مبلغ الدفع إلى حقل total_spend الخاص بذلك العميل في قاعدة بياناتك. تكون المبالغ بوحدة العملة الأصغر، لذا يمثل 5000 مبلغ $50.00.
2. حدّد الشرائح: اربط مبالغ الإنفاق بحدود المعدل:
   • الشريحة 1: إنفاق من $0 إلى $50 -> ‏3 RPM
   • الشريحة 2: إنفاق من $50 إلى $250 -> ‏10 RPM
   • الشريحة 3: إنفاق بقيمة $250 أو أكثر -> ‏50 RPM
3. طبّق الحدود: في API middleware، ابحث عن شريحة العميل وطبّق حد المعدل الخاص بها.

// db and the TIER_*_LIMITS constants are defined in your application.
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;
}

​

مثال كامل على التنفيذ: API Proxy

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: 'cde_your_credit_entitlement_id',
    });

    if (Number(balance.balance) <= 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. Meters منفصلة: أنشئ مجموعة من الـmeters لكل نموذج، مثل gpt-4o.input_tokens وgpt-4o-mini.input_tokens، مع Meter units per credit خاص بكل منها.
2. أحداث موزونة: استخدم meter واحدًا واضرب tokens في وزن قبل إرسال الحدث. مثلًا، إذا كانت تكلفة GPT-4o تساوي عشرة أضعاف تكلفة GPT-4o-mini، فأرسل عددًا من token يساوي عشرة أضعاف العدد لطلبات GPT-4o.

​

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

​

الخلاصة

​

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