الانتقال إلى المحتوى الرئيسي

نظرة عامة

يعيد هذا الـ endpoint تفاصيل الاستخدام على مستوى مفتاح API من دون كشف بيانات التوجيه الفيزيائي.

معلمات الاستعلام

المعاملالنوعالقيم الافتراضية / القيودالوصف
pageintegerالافتراضي 1، الحد الأدنى 1رقم الصفحة بدءًا من 1
limitintegerالافتراضي 50، الحد الأدنى 1، الحد الأقصى 100حجم الصفحة
logicalModelstringأقصى طول 100اسم النموذج المنطقي المطلوب
modelVendorstringأقصى طول 100مزود النموذج العام
sceneenum-chat و image و audio و video و embedding و rerank و translation و music و 3d
accessChannelenum-platform أو byok
startDatestring-حد سفلي شامل؛ يقبل RFC3339 مع منطقة زمنية أو YYYY-MM-DD
endDatestring-حد علوي شامل؛ يقبل RFC3339 مع منطقة زمنية أو YYYY-MM-DD
إذا تم إرسال startDate و endDate معًا، فيجب أن يكون startDate أسبق من أو مساويًا لـ endDate.

ملاحظات

  • هذه الاستجابة تدعم ترقيم الصفحات.
  • لا تتضمن الاستجابة إلا حقول الفوترة والتقارير العامة.
  • يتم إخفاء بيانات التوجيه الداخلي والقنوات الفيزيائية عمدًا.
  • تظل جميع الحقول المالية متاحة بقيم USD الأصلية، وتضيف الآن أيضًا حقول عرض بالرنمينبي مثل cost_cny و total_cost_cny و cost_cny داخل كل breakdown.
  • يمثل api_key.exchange_rate سعر USD→CNY المستخدم لكل قيم *_cny في تلك الاستجابة.

مثال

curl "https://api.lemondata.cc/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&accessChannel=platform&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-management-token"

الطلب / الاستجابة

استخدم لوحة OpenAPI التفاعلية أعلاه للاطلاع على المخطط الدقيق وحقول الاستجابة.