AR ▾
Base URL https://api.uncensoredaiapis.com/v1النموذج uncensored
احصل على مفتاح API
Uncensored AIدليل الترحيل

تتبع تكاليف API للذكاء الاصطناعي: مراقبة الإنفاق عبر الرؤوس

يمكنك بناء متتبع تكاليف ai api في حوالي خمسين سطرًا، لأن كل استجابة تُبلغك بالفعل بالرصيد المتبقي. يوضح هذا الدليل كيفية تسجيل الإنفاق لكل طلب، وقراءة نقاط نهاية الرصيد، ورفع تنبيه قبل نفاد الرصيد.

تم التحديث

لوحات واجهة عائمة مع رسم بياني هابط وجرس تنبيه برتقالي، لتوضيح مراقبة إنفاق API
خمس حجارة خطوة مضيئة تؤدي إلى مكعب خادم، توضح الخطوات للبدء باستخدام واجهة برمجة تطبيقات على طراز OpenAI

نقاط رئيسية

  • تحمل كل استجابة رأس X-Balance-USD الذي يحتوي على رصيدك المتبقي.
  • تعيد GET /v1/balance ونقطة نهاية credit_grants الرصيد عند الطلب.
  • تكلفة كل طلب هي (الإدخال × 0.15 + المخرجات × 0.50) / 1,000,000 دولار.
  • سجّل في CSV، ثم أنذر عندما ينخفض الرصيد تحت عتبة معينة.

مصدر الأرقام

يجعل الرصيد المسبق الدفع تتبع التكاليف أمراً بسيطاً، لأن المزوّد يحتفظ بالفعل بمجموع متواصل. يمكنك الحصول عليه في ثلاثة أماكن:

  • رأس الاستجابة X-Balance-USD في طلبات API، الذي يُظهر الرصيد المتبقي بعد الطلب.
  • GET /v1/balance، وهو استعلام بسيط عن الرصيد.
  • GET /v1/dashboard/billing/credit_grants، المسار على غرار OpenAI الذي تعرف الأدوات مثل لوحات التحكم والأغلفة كيفية استدعائه.

إلى جانب ذلك، تُعيد كل إكمال كائن usage يحتوي على عدد رموز الموجّه وإكمال النص. اجمع الرموز مع الأسعار ($0.15 لكل مليون رمز مدخل، و$0.50 لكل مليون رمز مخرج) ويمكنك حساب تكلفة أي طلب بنفسك، ثم مقارنته بالانخفاض في الرصيد. يجب أن يتطابق الاثنان. إذا لم يتطابقا، فقد وجدت شيئاً للتحقيق فيه. التفاصيل الكاملة للمعاملات موجودة في الوثائق.

قراءة الرأس في طلب واحد

مع curl، أضف -i وانظر إلى الرؤوس:

curl -si https://api.uncensoredaiapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hi."}]}' \
  | grep -i "x-balance-usd"

في بايثون، يُعرّض OpenAI SDK الاستجابات الخام عبر with_raw_response، مما يمنحك الرؤوس والكائن المُحلَّل معاً:

from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Say hi."}],
)
resp = raw.parse()
print(raw.headers.get("x-balance-usd"), resp.usage.total_tokens)

سجل صغير يسجل كل مكالمة

لف مكالماتك في دالة واحدة واكتب سطر CSV في كل مرة. يحتوي السطر على الوقت، ومعرف الطلب، وعدد الرموز، والتكلفة المحسوبة، والرصيد.

import csv, time
from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
PRICE_IN, PRICE_OUT = 0.15, 0.50   # dollars per 1M tokens
LOG = "api_spend.csv"

def cost(usage):
    return (usage.prompt_tokens * PRICE_IN + usage.completion_tokens * PRICE_OUT) / 1_000_000

def tracked_chat(messages, tag="default"):
    raw = client.chat.completions.with_raw_response.create(
        model="uncensored", messages=messages)
    r = raw.parse()
    row = [
        time.strftime("%Y-%m-%d %H:%M:%S"),
        raw.headers.get("x-request-id"),
        tag,
        r.usage.prompt_tokens,
        r.usage.completion_tokens,
        round(cost(r.usage), 6),
        raw.headers.get("x-balance-usd"),
    ]
    with open(LOG, "a", newline="") as f:
        csv.writer(f).writerow(row)
    return r, row

معامل tag هو الحيلة التي تجعل السجل مفيداً. مرر اسم ميزة مثل "summaries" أو "chat"، وبعد ذلك يمكنك جمع التكلفة حسب العلامة لمعرفة أي جزء من المنتج ينفق المال. يساعد معرف الطلب إذا احتجت يوماً إلى الاستفسار عن رسوم أو الإبلاغ عن مشكلة، لأنه يحدد المكالمة بالضبط.

التحقق من صحة الحساب

خذ مكالمة تحتوي على 2,400 رمز مدخل و600 رمز مخرج:

  • مدخل: 2,400 × 0.15 / 1,000,000 = $0.00036
  • مخرج: 600 × 0.50 / 1,000,000 = $0.00030
  • المجموع: $0.00066

تكلفة ألف من تلك المكالمة هي $0.66. إذا أظهر ملف CSV انخفاض الرصيد أسرع بكثير من مجموع التكاليف المحسوبة، فافحص عمليات إعادة المحاولة التي لم تسجلها، أو المهام الخلفية التي تستخدم نفس المفتاح، أو البث المتدفق الذي تركته مفتوحاً. الطلبات الفاشلة أو المرفوضة لا تُحسب تكلفتها، لذا لا ينبغي أن تؤثر الأخطاء في الرصيد إطلاقاً. قارن الإجماليات عبر العديد من المكالمات، وليس المكالمات الفردية، حتى تتلاشى فروق التقريب الصغيرة.

مكالمات البث المتدفق والاستخدام

مع stream: true، تصل أرقام الاستخدام في نهاية البث المتدفق. اجمعها من الشريحة الأخيرة، ثم اكتب السطر بعد إغلاق البث المتدفق.

def tracked_stream(messages, tag="chat"):
    usage = None
    for chunk in client.chat.completions.create(
            model="uncensored", messages=messages, stream=True):
        if chunk.choices and chunk.choices[0].delta.content:
            yield chunk.choices[0].delta.content
        usage = getattr(chunk, "usage", None) or usage
    if usage:
        with open(LOG, "a", newline="") as f:
            csv.writer(f).writerow([time.strftime("%F %T"), "", tag,
                usage.prompt_tokens, usage.completion_tokens, round(cost(usage), 6), ""])

إذا كنت بحاجة فقط إلى الرصيد، فاستدعِ GET /v1/balance بعد انتهاء البث المتدفق. إنه طلب رخيص، ويعمل أيضاً كفحص دوري من مهمة مجدولة.

تجميع الإنفاق حسب الميزة

لا فائدة من ملف CSV إلا إذا قرأته. يجمع هذا النص القصير التكلفة حسب الوسم ويعرض الرصيد الأحدث، دون الحاجة إلى حزم إضافية.

import csv
from collections import defaultdict

totals, last_balance = defaultdict(float), None
with open("api_spend.csv") as f:
    for row in csv.reader(f):
        ts, req_id, tag, pin, pout, cost_usd, balance = row
        totals[tag] += float(cost_usd)
        last_balance = balance or last_balance

for tag, usd in sorted(totals.items(), key=lambda kv: -kv[1]):
    print(f"{tag:15s} ${usd:.4f}")
print("latest balance:", last_balance)

شغّله يوميًا والصق المخرجات في قناة فريقك. يتحول الإنفاق غير المرئي إلى أرقام يمكن مناقشتها، وتبرز الميزة التي تكلف عشرة أضعاف الميزات الأخرى فورًا. للحصول على ميزانية تقريبية، اضرب المجموع اليومي في 30 وأضف هامش أمان بنسبة 20 بالمائة.

إضافة تنبيه انخفاض الرصيد

نفاد الرصيد خلال اليوم يؤدي إلى إيقاف المنتج، لذا تنبّه مبكراً. جدولة cron التي تعمل كل 15 دقيقة تكفي.

import requests

BASE = "https://api.uncensoredaiapis.com/v1"
THRESHOLD = 5.00   # dollars

r = requests.get(BASE + "/balance", headers={"Authorization": "Bearer sk-your-key"}, timeout=10)
print(r.status_code, r.text)   # inspect the JSON once to see the field name
# After you know the field name, parse it and compare with THRESHOLD,
# then post to your chat webhook or send an email.

اطبع ملف JSON الخام وانظر إليه قبل كتابة كود التحليل. يستغرق اسم الحقل الحقيقي عشر ثوانٍ للتحقق منه، وقد يكسر التنبيه بصمت إذا خمنت الاسم من مقال. اختر عتبة تغطي يومًا واحدًا على الأقل من الإنفاق العادي، وهو ما يخبرك به ملف CSV: اجمع تكلفة أمس واستخدمها كحد أدنى.

عند إطلاق التنبيه، شحن الرصيد. أي مبلغ صحيح من $20 إلى $500 يعمل، مع إضافة 5% رصيد من $50، و10% من $100، و15% من $200، ولا ينتهي الرصيد. للحصول على مفتاح API لتتبع الإنفاق أولاً، استخدم صفحة مفتاح API.

عادات تجعل الإنفاق متوقعًا

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

عادة أخرى: احفظ معرّف الطلب مع كل صف مسجل. إذا بدا رقم غير صحيح بعد شهر، يمكنك مطابقته مع طلب معين بدلاً من الاعتماد على المتوسطات. لأن الطلبات الفاشلة لا تُحسب تكلفتها، فإن إعادة المحاولة عند الأخطاء لا تزيد التكلفة، لكن إعادة المحاولة بعد إجابة ناجحة تزيد التكلفة، لذا تأكد من أن منطق إعادة المحاولة يعمل فقط عند الفشل الحقيقي. الخلل الذي يعيد إرسال طلب ناجح في حلقة هو السبب الأكثر شيوعاً لفاتورة مفاجئة مع أي API مدفوع حسب الرمز.

أسئلة وأجوبة

هل يظهر رأس الرصيد في كل الاستجابات؟

رأس X-Balance-USD جزء من رؤوس الاستجابة المذكورة لهذا API. اقرأه من الاستجابة الخام واعتبر القيمة المفقودة غير معروفة.

هل يمكنني الحصول على التكلفة دون تسجيل كل طلب؟

نعم. استعلم عن GET /v1/balance على جدول زمني واحسب الفرق بين القراءات.

هل تغير الطلبات الفاشلة الرصيد؟

لا. الطلبات الفاشلة أو المرفوضة لا يتم خصم تكلفتها.

أي نقطة نهاية يجب أن تستخدمها أداة لوحة تحكم OpenAI الحالية؟

استخدم مسار GET /v1/dashboard/billing/credit_grants على نمط OpenAI، الذي تدعمه العديد من الأدوات بالفعل.

مفتاحك على بُعد نموذج واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.