تخطَّ إلى المحتوى

مستندات المطور UlazAI

المصادقة

نموذج المصادقة

تدعم نقاط نهاية API للصور والفيديو مصادقة مفتاح API. للخارجية عمليات التكامل، استخدم مفتاح API مع ملف Authorization header.

هام: /api/register/ و /api/login/ هي المعوقين حاليا والعودة 403. استخدم تدفق تسجيل الدخول عبر الويب ومفتاح API الإدارة بدلا من ذلك.

الإعداد الموصى به

  1. تسجيل الدخول في /الحسابات/تسجيل الدخول/.
  2. قم بإنشاء مفتاح API في لوحة المعلومات الخاصة بك، أو عبر POST /api/api-keys/ في حين مصادقة.
  3. إرسال الطلبات إلى /api/v1/... مع المفتاح الخاص بك في Authorization.
  4. لاكتشاف النموذج، اتصل /api/v1/models/image/ و /api/v1/models/video/.

تنسيقات رأس التفويض

تقبل الواجهة الخلفية تنسيقات رأس مصادقة متعددة.

Authorization: Bearer YOUR_API_KEY
Authorization: Token YOUR_API_KEY
Authorization: YOUR_API_KEY

إنشاء مفتاح API (مصادقة الجلسة)

إذا قمت بتسجيل الدخول باستخدام جلسة متصفح، فيمكنك إنشاء المفاتيح برمجيًا.

curl -X POST https://ulazai.com/api/api-keys/ \
  -H "Content-Type: application/json" \
  -H "X-CSRFToken: YOUR_CSRF_TOKEN" \
  -H "Cookie: sessionid=YOUR_SESSION" \
  -d '{
    "name": "Production key"
  }'

تتضمن الاستجابة المفتاح الكامل مرة واحدة. قم بتخزينه على الفور.

استكشاف أخطاء المصادقة وإصلاحها

  • 401 يعني أن المفتاح مفقود أو غير صالح أو تم إبطاله.
  • 402 يمكن أن يشير إلى عدم وجود أرصدة تم شراؤها لاستخدام API.
  • أرصدة ترحيبية متاحة على موقع الويب فقط ولا يمكن استخدامها عبر API.