حساب تعريفي

استخدم نقاط نهاية ملف التعريف لفحص معرف حساب مالك المفتاح API والطبقة والائتمانات وحصة API المتبقية. قم باستدعاء نقطة النهاية هذه قبل الدفعات الكبيرة، وبعد المهام المهمة، وأثناء عمليات الفحص التشغيلي.

احصل على الملف الشخصي

GET /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY

طلب

الطلب لا يحتاج إلى هيئة.

curl https://kittaai.com/api/open/v1/profile \
  -H "Authorization: Bearer KITTA_API_KEY"

إجابة

{
  "user_id": "user_123",
  "api_quota_remaining": 988000,
  "tier": "pro",
  "credits": 1200
}

تعامل مع الحقول غير المعروفة كإضافة وتجنب فشل المحللين الصارمين عندما تحصل الاستجابة على حساب جديد أو بيانات تعريف الفوترة.

تحديث الملف الشخصي

POST /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY
Content-Type: application/json

{
  "webhookUrl": "https://example.com/webhooks/fishspeech"
}

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

الفواتير والائتمانات

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

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

أخطاء