Skip to main content
أنشئ مفتاحًا في لوحة التحكم، واحفظه على خادمك وأرسله كرمز Bearer مع طلبات Gateway.

أنواع المفاتيح

  • مفاتيح API الخاصة بـ Gateway تستدعي نقاط نهاية النماذج والمزوّدين والتوليد المتاحة لمساحة العمل.
  • مفاتيح API للإدارة تستدعي واجهات الإدارة. راجع مفاتيح API للإدارة.
دوّر المفتاح بتحديث تطبيقك لاستخدام البديل قبل إبطال بيانات الاعتماد القديمة. راجع نقطة نهاية تدوير المفاتيح. تتبع المفاتيح التنسيق phaseo_v1_sk_<kid>_<secret>. تعامل معها ككلمات مرور، وتجنب حفظها في شيفرة جهة العميل أو المستودعات العامة.
يمكنك استدعاء نماذج :free دون إيداع رصيد. تتطلب النماذج المدفوعة رصيداً متاحاً في المحفظة.

تنسيق الترويسة

أدرج المفتاح في ترويسة Authorization مع كل طلب:
تتيح معظم برامج HTTP ضبط ذلك مرة واحدة. إليك مثالاً باستخدام fetch:

قائمة التحقق لإدارة المفاتيح


أخطاء المصادقة الشائعة

  • 401 غير مصرح به: المفتاح مفقود أو غير صالح أو مرتبط بمساحة عمل معطّلة.
  • 403 محظور: المفتاح موجود، لكنه لا يتيح الوصول إلى المزوّد أو النموذج المطلوب.
  • 429 Too Many Requests: تجاوز المفتاح أو مساحة العمل حدًا. راجع حدود الطلبات.
  • أخطاء 5xx: أعد المحاولة مع تأخير أُسّي، وتواصل مع الدعم إذا استمرت المشكلة.
آخر تعديل في ٢ أكتوبر ٢٠٢٦