متوسط الإنفاق اليومي لهذا الشهر مُسقطًا على الرصيد؛ ويُعرض بالصيغة 0 days أو 1 day أو N days أو 365+ days أو Not enough data
حدود إنفاق الحساب
الحد
إعادة التعيين
القيم المسبقة
الحد اليومي
كل يوم عند منتصف الليل، بالتوقيت المحلي للمنشأة
$25، $50، $100، $250
الحد الشهري
اليوم الأول من كل شهر، بالتوقيت المحلي للمنشأة
$50، $100، $250، $500، $1000
الإجمالي (السقف الثابت)
إعادة تعيين يدوية فقط (Reset hard cap: يعود العدّاد إلى $0، ولا يتغير السقف، وتُحفظ الفترة المغلقة في سجل إعادة التعيين)
—
يمكن تفعيل أي مجموعة منها. تنطبق الحدود على جميع مفاتيح API والخدمات المتصلة مجتمعة؛ ويظل الرصيد المدفوع مسبقًا ساريًا فوق ذلك. يؤدي تجاوز الحد إلى حظر الطلبات مع خطأ 402 budget_exceeded إلى أن تُعاد تعيين الفترة.
الإعدادات لكل مفتاح أو لكل خدمة
الإعداد
الافتراضي
ملاحظات
التسمية
فارغة
اختيارية؛ تُستخدم لنسب الاستخدام في Activity وLogs
نوع الاتصال (مفاتيح API فقط)
API key
يبقى API key في قائمة مفاتيح API؛ ويظهر External agent ضمن Connected Services
حد الإنفاق اليومي
متوقف
يُعاد تعيينه في بداية كل يوم، وفق المنطقة الزمنية للمنشأة
حد الإنفاق الشهري
متوقف
يُعاد تعيينه في اليوم الأول من كل شهر، وفق المنطقة الزمنية للمنشأة
السقف مدى الحياة
متوقف
إجمالي الإنفاق طوال عمر المفتاح أو الخدمة؛ ولا يُعاد تعيينه أبدًا
Requests / min
غير محدود
يؤدي التجاوز إلى إرجاع HTTP 429
Tokens / min
غير محدود
يؤدي التجاوز إلى إرجاع HTTP 429
تقييد النماذج
متوقف (جميع النماذج المفعّلة في المنشأة)
لا يمكن استخدام سوى النماذج المحددة مع هذا المفتاح أو هذه الخدمة
تجاوز Guardrails المنشأة
متوقف (يرث إعدادات المنشأة)
عند تشغيله، يُطبَّق اختيار المفتاح أو الخدمة الخاص، بما في ذلك "none"
حالات مفاتيح API وإجراءاتها
الحالة
المعنى
Active
المفتاح يعمل.
Provisioning…
تظهر لفترة وجيزة أثناء إعداد مفتاح جديد.
Disabled
المفتاح مُبطَل (ويظهر الصف باهتًا)؛ ويمكن إعادة تفعيله.
الإجراء
قابل للتراجع؟
التأثير
Edit
—
تغيير التسمية والحدود والنماذج وGuardrails.
Rotate
لا
يُصدر سر جديد (يُعرض مرة واحدة)؛ ويتوقف السر القديم عن العمل فورًا.
Revoke
نعم (Re-activate)
يُعطَّل المفتاح فورًا.
Delete
لا
يُزال المفتاح نهائيًا.
النماذج
العنصر
القيمة
الافتراضي
جميع نماذج الكتالوج مفعّلة
Automatically enable new models
عند تشغيله، تُفعَّل النماذج المضافة حديثًا إلى الكتالوج للمنشأة تلقائيًا
معرّف النموذج: auto؛ Usage-priced، أي تُحتسب الرسوم بسعر النموذج الذي يختاره الموجّه لكل طلب.
يمكن تعديل التوجيه لكل منشأة عبر Edit routing (لا يمكن اختيار سوى النماذج المفعّلة؛ ويجب أن يكون لكل مستوى نموذج)؛ ويستعيد Reset to default الخريطة القياسية.
تعرض Logs وActivity النموذج المختار؛ ويعرض درج الطلب auto بوصفه Requested model.
ضوابط الأمان
إجراء الحماية
الإجراء عند المطابقة
PII masking
يخفي البيانات الشخصية في المطالبة؛ ويستمر الطلب
Secret redaction
يزيل المفاتيح والرموز المميزة والأسرار من المطالبة؛ ويستمر الطلب
Prompt-injection shield
يحظر الطلب (403 content_policy_violation)
القالب
ما يفعّله
None
لا شيء (الافتراضي)
PII protection
PII masking
Secret redaction
Secret redaction
Injection shield
Prompt-injection shield
Strict
الثلاثة جميعها
عوامل تصفية المحتوى
العنصر
القيمة
الحد الأقصى لعوامل التصفية لكل منشأة
25
الحد الأقصى لطول النمط
300 حرف
الإجراءات
Redact (إعادة كتابة النصوص المطابقة إلى [REDACTED]) أو Block (الرفض مع 403)
أمان الأنماط
تُستبعد التعبيرات النمطية غير الآمنة (مثل الأنماط المعرّضة للتراجع الكارثي) والأنماط التي تتجاوز 300 حرف ولا تُطبَّق
الوراثة
على مستوى المنشأة؛ وتستخدم المفاتيح والخدمات التي فُعّل لها تجاوز Guardrails قائمتها الخاصة
سجل المعاملات
يسرد سجل المعاملات عمليات الشحن وتعديلات الرصيد فقط. ويُلخَّص الاستخدام في Monthly usage.
النوع
المعنى
Top-up
عملية دفع بالبطاقة تضيف رصيدًا
Refund
عملية دفع مستردة
Adjustment
تصحيح يدوي للرصيد
العنصر
القيمة
الأعمدة
Date وType وAmount وBalance after وReceipt
الإيصالات المجمّعة
حدّد الصفوف، ثم انقر على Download receipts (n)
الاستخدام الشهري
العنصر
القيمة
التجميع
الشهر التقويمي (UTC)؛ ويحمل الشهر الحالي الوسم Month to date
التسوية
كل 15 دقيقة مع الرصيد المدفوع مسبقًا
الأعمدة
Month وUsage وDeductions وDownloads
نوع الخصم
Usage charge (إنفاق الاستدلال المُسوّى)، ويُدرج عند توسيع الشهر
كشوف استخدام وليست فواتير؛ ولا تصدر إيصالات إلا لعمليات الشحن بالبطاقة
النشاط والسجلات
العنصر
القيمة
عروض Activity
Overview وTrends وPerformance وExplore
النطاقات المسبقة
Last 24 hours وLast 7 days وLast 30 days وLast 90 days وYear وAll time وCustom range
النطاقات المسبقة في Logs
Last 15 minutes وLast hour وLast 24 hours (الافتراضي) وLast 7 days وLast 30 days ونطاق مخصص؛ والتحديث المباشر Live بقيم Off / 10s / 30s (الافتراضي) / 60s
خيارات التجميع في Explore
Model وAPI key / agent وSource وProvider وStatus
الحد الأقصى لتصدير CSV الأولي
25,000 صف
أنواع التصدير
Raw requests؛ وSummary by model / by key & agent / by source / by period (تغطي الملخصات أيامًا كاملة)
المحتوى المخزَّن
البيانات الوصفية فقط، ولا يُخزَّن محتوى المطالبات أو الاستجابات أبدًا
استجابات أخطاء API
عنوان URL الأساسي: يُعرض في الإعدادات ← Service Access & API Keys ← Connecting to the API (مثل https://app.performancehub.co/ai/v1). تستخدم الأخطاء بنية OpenAI { "error": { "message", "type", "code" } }.
HTTP
type
code
المعنى
401
invalid_request_error
invalid_api_key
مفتاح API مفقود، أو بيانات اعتماد غير صالحة لخدمة متصلة
401
invalid_request_error
—
مفتاح API غير معروف أو مُبطَل ("Invalid API key")
402
insufficient_quota
insufficient_credits
نفد الرصيد المدفوع مسبقًا (أو، بالنسبة إلى الخدمات المتصلة، المنشأة غير مفعّلة)
402
insufficient_quota
budget_exceeded
بُلغ أحد حدود الإنفاق (المنشأة أو المفتاح أو الخدمة المتصلة)؛ ويتضمن نص الاستجابة window وresetsAt وtimezone وdocsUrl
403
invalid_request_error
—
"Model Router is not enabled for this facility" (مفاتيح API)، أو "Facility has no provisioned inference key" (لا يوجد مفتاح استدلال داعم للمفتاح)
403
invalid_request_error
content_policy_violation
حُظر بواسطة عامل تصفية محتوى أو درع الحماية من حقن المطالبات
429
—
—
تجاوز حد المعدل للطلبات في الدقيقة أو الرموز المميزة في الدقيقة
502
server_error
—
خدمة الاستدلال الأولية غير متاحة (أعد المحاولة)
يؤدي حدوث إخفاق غير متوقع أثناء التحقق من مفتاح API إلى إرجاع HTTP 500 "Something went wrong"؛ أعد محاولة الطلب.
