Unlimited API

المصادقة ونطاقات الصلاحية

أرسل مفتاح API الخاص بالعميل عبر HTTPS في ترويسة Authorization: Bearer. لا تضع المفاتيح في عناوين URL. يتطلب الاستدلال عبر Unlimited النطاق ai:inference، وتتطلب مسارات عروض التدريب والمهام وحالتها والملفات الناتجة ai:training. تطبق حدود لمعدل الطلبات. كما يقتصر مفتاح مرجع التدريب على النموذج المصرح به تحديداً.

إدارة مفاتيح API من لوحة التحكم

• POST /api/v1/chat/completions Authorization: Bearer ai:inference

قراءة الوثائق

إكمال المحادثة

تقبل نقطة النهاية المتوافقة مع OpenAI طلب POST بصيغة JSON وتعيد إكمالاً للمحادثة. يجب أن يكون محتوى الرسالة نصاً؛ والأدوار المقبولة هي system وuser وassistant.

يُمرر معرّف النموذج والرسائل إلى بوابة الذكاء الاصطناعي الافتراضية المضبوطة حالياً. لا يضمن ذلك توجيهاً مباشراً إلى مزوّد محدد ولا يفرض استخدام SDK بعينه.

POST https://fusionpointai.com/api/v1/chat/completions · ai:inference

استخدم معرّف نموذج المزوّد كما يظهر تماماً في كتالوج Unlimited API. مصدر المعرّفات والتوافر هو الكتالوج وقد يتغيران؛ المعرّف في المثال عنصر نائب وليس معرّف نموذج صالحاً للاستخدام.

محتوى الطلب

هذا مثال توضيحي فقط. استبدل كل قيمة بين الأقواس الزاوية ببياناتك. أرقام معرّفات النموذج المرجعي والخطة والفاتورة عناصر نائبة وليست سجلات فعلية.

{
    "model": "<MODEL_ID_FROM_UNLIMITED_CATALOGUE>",
    "messages": [
        {
            "role": "user",
            "content": "<YOUR_PROMPT>"
        }
    ],
    "temperature": 0.2,
    "max_tokens": 512
}

الاستجابة والأخطاء

تتضمن الاستجابة الناجحة الحقول id وobject وcreated وmodel، إضافة إلى حقلي choices وusage اللذين يعيدهما المزوّد. تعيد الطلبات غير الصالحة HTTP 400 مع error.message وerror.type وerror.code وتفاصيل الحقول. تعيد أعطال المزوّد HTTP 500 مع provider_error. وقد تظهر أيضاً أخطاء المصادقة والنطاق وحدود الطلبات.

الأخطاء الشائعة

• 400 invalid_request_error حقل مطلوب مفقود أو قيمة خارج التنسيق أو النطاق المقبول.
• 401 مفتاح Bearer مفقود أو غير صالح أو ملغى أو مقيّد.
• 403 المفتاح لا يملك ai:inference، أو استُخدم مفتاح مرجع التدريب مع نموذج آخر.
• 429 تم بلوغ حد الطلبات؛ انتظر قبل إعادة المحاولة.
• 500 provider_error لم يُرجع مزوّد الاستدلال إكمالاً.

الأسئلة الشائعة