كيفية استخدام واجهة برمجة تطبيقات بيربلكسيتى AI مع، أو بدون حساب برو

لقد اكتسبت Perplexity AI شهرة كبيرة بفضل قدراتها في الذكاء الاصطناعي التفاعلي، وخاصة قوتها في تقديم إجابات محدثة ومعتمدة على مصادر من خلال دمج البحث على الويب في الوقت الحقيقي في ردودها. للمطورين والشركات الذين يتطلعون للاستفادة من هذه النماذج القوية ضمن تطبيقاتهم الخاصة، توفر Perplexity واجهة برمجة التطبيقات (API).

تتيح واجهة برمجة التطبيقات Perplexity AI الوصول البرمجي إلى نماذج اللغة الكبيرة (LLMs) الخاصة بـ Perplexity، بما في ذلك نماذجها المباشرة (مثل sonar-small-online و sonar-medium-online) التي يمكنها تصفح الويب للإجابة على الاستفسارات، ونماذج الدردشة غير المتصلة (مثل sonar-small-chat و sonar-medium-chat).

يستعرض هذا الدليل طريقتين رئيسيتين للتفاعل مع نظام واجهة برمجة التطبيقات لـ Perplexity AI:

1. الوصول المباشر باستخدام مفتاح واجهة برمجة التطبيقات الرسمي من Perplexity: هذه هي الطريقة القياسية التي توفرها Perplexity. على الرغم من أنه قد يكون هناك فترة تجريبية مجانية محدودة أو اعتمادات تمهيدية، فإن الاستخدام المستدام أو عالي الحجم يتطلب عادة اشتراك Perplexity Pro أو ترتيبات محددة للشركات للحصول على واستخدام مفتاح واجهة برمجة التطبيقات مع الاعتمادات الكافية.
2. الوصول غير المباشر عبر الخدمات الخارجية (OpenRouter): تعمل منصات مثل OpenRouter كموحدات، حيث توفر الوصول إلى مجموعة متنوعة من نماذج LLM، بما في ذلك نماذج Perplexity، من خلال بنية واجهة برمجة التطبيقات الخاصة بها. يمكن أن تكون هذه وسيلة بديلة لاستخدام نماذج Perplexity، ربما دون الحاجة إلى اشتراك مباشر في Perplexity Pro، على الرغم من أنك ستتحمل تكاليف من خلال مزود الطرف الثالث.

سوف نقوم أيضًا بتوضيح الوضع فيما يتعلق بـ Groq، وهي منصة استدلال شعبية أخرى، وعلاقتها (أو عدم وجودها) مع نماذج Perplexity الخاصة.

الوصول إلى واجهة برمجة التطبيقات الرسمية لـ Perplexity AI باستخدام حساب محترف

يصف هذا القسم كيفية استخدام واجهة برمجة التطبيقات الرسمية التي تقدمها Perplexity مباشرة. غالبًا ما توفر هذه الطريقة الوصول الأكثر مباشرة وربما أحدث الميزات أو النماذج، لكنها عادةً ما تتطلب اشتراكًا مدفوعًا من Perplexity (Pro) لاستخدام فعّال يتجاوز الاستكشاف الأولي.

المتطلبات المسبقة:

• حساب في Perplexity.
• اشتراك في Perplexity Pro (مطلوب عادةً للوصول الكبير إلى واجهة برمجة التطبيقات وتوليد المفتاح).
• فهم أساسي لواجهات برمجة التطبيقات REST وكيفية إجراء طلبات HTTP (باستخدام أدوات مثل curl أو لغات البرمجة مثل Python).

الخطوة 1: الحصول على مفتاح واجهة برمجة التطبيقات الرسمي من Perplexity AI

1. تسجيل الدخول إلى Perplexity: توجه إلى موقع Perplexity (perplexity.ai) وقم بتسجيل الدخول إلى حسابك. تأكد من ترقية حسابك إلى Pro إذا كان مطلوبًا لتوليد/استخدام مفتاح واجهة برمجة التطبيقات.
2. إعداد وسيلة الدفع: ابحث عن إعدادات الحساب، خيارات الملف الشخصي، أو قسم مخصص لـ "API" في لوحة معلومات Perplexity الخاصة بك. قد يتغير الموقع الدقيق، لكنه عادة ما يكون تحت منطقة إدارة حسابك.

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

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

الخطوة 2: فهم نقطة نهاية واجهة برمجة التطبيقات لـ Perplexity AI

نقطة النهاية الرئيسية للتفاعل مع نماذج الدردشة الخاصة بـ Perplexity عبر واجهة برمجة التطبيقات هي:

https://api.perplexity.ai/chat/completions

تتبع هذه النقطة بنية مشابهة لواجهة برمجة تطبيقات OpenAI، مما يجعلها مألوفة نسبيًا للمطورين الذين تعاملوا مع واجهات برمجة التطبيقات الأخرى لـ LLM.

الخطوة 3: اختيار نموذج واجهة برمجة التطبيقات لـ Perplexity AI

تقدم Perplexity العديد من النماذج من خلال واجهة برمجة التطبيقات الخاصة بها. تحتاج إلى تحديد أي نموذج تريد استخدامه في طلبك لـ API. تشمل النماذج الشائعة:

النماذج المباشرة (مع البحث على الويب):

• sonar-small-online
• sonar-medium-online
• (سابقًا pplx-7b-online، pplx-70b-online - تحقق من الوثائق الحالية للحصول على النماذج المتاحة)

نماذج الدردشة (بدون بحث على الويب):

• sonar-small-chat
• sonar-medium-chat
• (سابقًا pplx-7b-chat، pplx-70b-chat - تحقق من الوثائق الحالية)
• قد تتوفر نماذج متخصصة أو قديمة أخرى أيضًا. دائمًا ما يُفضل الرجوع إلى الوثائق الرسمية لـ Perplexity API للحصول على أحدث قائمة بالنماذج وقدراتها.

الخطوة 4: إجراء أول طلب واجهة برمجة تطبيقات لـ Perplexity AI

يمكنك التفاعل مع واجهة برمجة التطبيقات باستخدام أدوات أو لغات برمجة متنوعة. إليك بعض الأمثلة باستخدام curl (أداة سطر الأوامر) وPython (requests المكتبة).

باستخدام curl:

curl -X POST <https://api.perplexity.ai/chat/completions> \\\\
     -H "Authorization: Bearer YOUR_PERPLEXITY_API_KEY" \\\\
     -H "Content-Type: application/json" \\\\
     -d '{
       "model": "sonar-medium-online",
       "messages": [
         {
           "role": "system",
           "content": "كن دقيقًا وموجزًا."
         },
         {
           "role": "user",
           "content": "ما هي الفوائد الرئيسية لاستخدام واجهة برمجة التطبيقات Perplexity AI؟"
         }
       ],
       "max_tokens": 500,
       "temperature": 0.7
     }'

الشرح:

• curl -X POST ...: ينشئ طلب POST HTTP إلى نقطة النهاية المحددة.
• H "Authorization: Bearer YOUR_PERPLEXITY_API_KEY": يوفر هذا العنوان بيانات اعتماد المصادقة الخاصة بك. استبدل YOUR_PERPLEXITY_API_KEY بالمفتاح الذي قمت بتوليده.
• H "Content-Type: application/json": يُعلم الخادم أن محتوى الطلب هو بتنسيق JSON.
• d '{...}': يحدد حمولة JSON (البيانات) التي يتم إرسالها.
• "model": النموذج المحدد لـ Perplexity الذي ستستخدمه (على سبيل المثال، sonar-medium-online).
• "messages": قائمة من كائنات الرسالة تحدد تاريخ المحادثة.
• "role": يمكن أن تكون "system" (تحدد سلوك الذكاء الاصطناعي)، "user" (مدخلاتك)، أو "assistant" (ردود الذكاء الاصطناعي السابقة).
• "content": نص الرسالة.
• "max_tokens" (اختياري): الحد الأقصى لعدد الرموز التي سيتم إنتاجها في الرد.
• "temperature" (اختياري): يتحكم في العشوائية (0 = محدد، أعلى = أكثر إبداعًا/عشوائية).

باستخدام Python (requests المكتبة):

أولاً، تأكد من تثبيت مكتبة requests: pip install requests

import requests
import json
import os

# تحميل مفتاح API لديك بأمان (على سبيل المثال، من متغير بيئي)
api_key = os.environ.get("PERPLEXITY_API_KEY")
# أو قم بإلغاء تعليق واستبداله مباشرة (أقل أمانًا للإنتاج):
# api_key = "YOUR_PERPLEXITY_API_KEY"

if not api_key:
    print("خطأ: متغير البيئة PERPLEXITY_API_KEY غير مضبط.")
else:
    url = "<https://api.perplexity.ai/chat/completions>"

    payload = {
        "model": "sonar-medium-online",
        "messages": [
            {
                "role": "system",
                "content": "قدّم شروحًا مفصلة واستشهد بالمصادر."
            },
            {
                "role": "user",
                "content": "اشرح مفهوم الجيل المعزز بالاسترجاع (RAG)."
            }
        ],
        "max_tokens": 800,
        "temperature": 0.5,
        # إضافة معلمات أخرى مثل 'frequency_penalty'، 'presence_penalty' إذا لزم الأمر
    }

    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }

    try:
        response = requests.post(url, headers=headers, json=payload)
        response.raise_for_status() # أطلق استثناءً للرموز الحالة السيئة (4xx أو 5xx)

        response_data = response.json()
        print(json.dumps(response_data, indent=2))

        # استخراج رد الذكاء الاصطناعي
        if response_data.get("choices"):
             assistant_message = response_data["choices"][0]["message"]["content"]
             print("\\\\n رد المساعد:\\\\n", assistant_message)

    except requests.exceptions.RequestException as e:
        print(f"حدث خطأ: {e}")
        if e.response is not None:
            print("تفاصيل الخطأ:", e.response.text)

الخطوة 5: اختبار مفتاح واجهة برمجة التطبيقات لـ Perplexity AI باستخدام APIdog

قبل دمج مفتاح واجهة برمجة التطبيقات في تطبيقك، من الحكمة اختباره للتأكد من أنه يعمل بشكل صحيح. APIdog هو أداة سهلة الاستخدام لاختبار واجهات برمجة التطبيقات. إليك كيفية استخدامه لاختبار مفتاح Perplexity الخاص بك:

قم بتنزيل وفتح APIdog: قم بتشغيل تطبيق APIdog أو استخدم النسخة عبر الإنترنت.

إنشاء طلب جديد: انقر على زر "+" أو خيار مماثل لإنشاء طلب API جديد.

تعيين الطريقة إلى POST: قم بتغيير القائمة المنسدلة لطريقة HTTP إلى POST.

أدخل عنوان نقطة النهاية: في حقل إدخال URL، انسخ وعُدّل عنوان نقطة النهاية لإكمالات الدردشة من Perplexity: https://api.perplexity.ai/chat/completions

تكوين المصادقة:

• انتقل إلى علامة تبويب "المصادقة" أسفل شريط عنوان URL.
• اختر "Token حاملي" من القائمة المنسدلة.
• في حقل "الرمز"، انسخ مفتاح واجهة برمجة التطبيقات لـ Perplexity AI الذي حصلت عليه في الخطوة 1.

تعيين رأس Content-Type:

• انتقل إلى علامة تبويب "الرؤوس".
• أضف رأسًا جديدًا. ضع المفتاح على Content-Type والقيمة على application/json.

إنشاء جسم الطلب:

• انتقل إلى علامة تبويب "الجسم".
• اختر الخيار "نقي" واختر "JSON" من القائمة المنسدلة بجانبه.
• الصق بنية JSON التالية في المساحة النصية، مع استبدال "sonar-medium-online" بالنموذج الذي ترغب في اختباره وتعديل "content" إذا رغبت:

{
  "model": "sonar-medium-online",
  "messages": [
    {
      "role": "system",
      "content": "كن دقيقًا وواقعيًا."
    },
    {
      "role": "user",
      "content": "كم عدد الأقمار التي تمتلكها المريخ؟"
    }
  ]
}

إرسال الطلب: انقر على زر "إرسال".

تحقق من الرد: سيعرض APIdog الرد من واجهة برمجة التطبيقات لـ Perplexity. ابحث عن رمز الحالة 200 OK ورمز JSON يحتوي على إجابة الذكاء الاصطناعي في حقل choices[0].message.content. إذا حصلت على خطأ (مثل 401 Unauthorized أو 403 Forbidden)، تحقق مرة أخرى من أنه تم لصق مفتاح واجهة برمجة التطبيقات بشكل صحيح في علامة تبويب المصادقة وأن حساب/مفتاح Perplexity الخاص بك لديه التصاريح والاعتمادات اللازمة.

استخدام نماذج واجهة برمجة التطبيقات لـ Perplexity AI بدون حساب Pro مباشر (مع Openrouter)

إذا لم يكن لديك اشتراك في Pro من Perplexity أو تفضل نموذج فواتير/وصول مختلف، يمكنك غالبًا استخدام نماذج Perplexity من خلال مزودي واجهات برمجة التطبيقات الخارجية. OpenRouter هو مثال شائع.

يوفر OpenRouter نقطة نهاية API موحدة للوصول إلى مجموعة واسعة من نماذج LLM من مزودين مختلفين، بما في ذلك Perplexity. تدفع لـ OpenRouter بناءً على استخدامك، وهم يديرون الاتصال بخلفية مزودي النماذج المعنيين.

يمكنك التحقق من واجهة برمجة التطبيقات المتاحة لـ Perplexity AI هنا:

المتطلبات المسبقة:

• حساب OpenRouter (openrouter.ai).
• تمويل مضاف إلى حساب OpenRouter الخاص بك أو إعداد فواتير.
• فهم أساسي لواجهات برمجة التطبيقات REST.

الخطوة 1: الحصول على مفتاح واجهة برمجة التطبيقات لـ OpenRouter

1. اشترك/سجل الدخول: توجه إلى openrouter.ai وأنشئ حسابًا أو سجل الدخول.
2. انتقل إلى المفاتيح: ابحث عن قسم "المفاتيح" أو "مفاتيح API" في إعدادات حسابك.
3. إنشاء مفتاح: قم بتوليد مفتاح API جديد.
4. انسخه واحتفظ به: انسخ المفتاح الذي تم توليده وخزنه بأمان، تمامًا مثل مفتاح Perplexity الرسمي.

الخطوة 2: تحديد نماذج واجهة برمجة التطبيقات لـ Perplexity AI على OpenRouter

يستخدم OpenRouter قاعدة تسميات خاصة به، غالبًا ما يضع بادئة لاسم المزود. قد تبدو نماذج Perplexity على OpenRouter مثل:

• perplexity/sonar-small-chat
• perplexity/sonar-small-online
• perplexity/sonar-medium-chat
• perplexity/sonar-medium-online
• (تحقق من صفحة /models على OpenRouter للحصول على القائمة الحالية والأسماء الدقيقة)

الخطوة 3: إجراء طلب واجهة برمجة التطبيقات عبر نقطة نهاية OpenRouter لنماذج واجهة برمجة التطبيقات لـ Perplexity AI

يستخدم OpenRouter نقطة نهاية واجهة برمجة التطبيقات متوافقة مع OpenAI:

https://openrouter.ai/api/v1/chat/completions

هيكل طلبك مربت مثل واجهة برمجة التطبيقات الرسمية لـ Perplexity أو واجهة برمجة APIs لـ OpenAI، ولكن استخدم مفتاح OpenRouter واسم النموذج الخاص بـ OpenRouter.

باستخدام curl:

curl -X POST <https://openrouter.ai/api/v1/chat/completions> \\\\
  -H "Authorization: Bearer YOUR_OPENROUTER_API_KEY" \\\\
  -H "Content-Type: application/json" \\\\
  -H "HTTP-Referer: YOUR_SITE_URL" \\\\ # اختياري، لكن موصى به من قبل OpenRouter
  -H "X-Title: YOUR_APP_NAME" \\\\      # اختياري، لكن موصى به من قبل OpenRouter
  -d '{
    "model": "perplexity/sonar-medium-online",
    "messages": [
      {"role": "user", "content": "كيف يوفر OpenRouter الوصول إلى نماذج واجهة برمجة التطبيقات لـ Perplexity AI؟"}
    ]
  }'

ملاحظة: يوصي OpenRouter بإضافة رؤوس HTTP-Referer وX-Title لتحديد تطبيقك. استبدل YOUR_OPENROUTER_API_KEY وYOUR_SITE_URL وYOUR_APP_NAME وفقًا لذلك.

الخطوة 4: التعامل مع رد OpenRouter لنماذج واجهة برمجة التطبيقات لـ Perplexity AI

هيكل الرد من OpenRouter هو عمومًا مطابق لنموذج OpenAI/Perplexity القياسي، بما في ذلك choices وmessage وcontent وusage الحقول. الفرق الرئيسي هو أن التكاليف تُحسب بناءً على تسعير OpenRouter للنموذج Perplexity الذي استخدمته.

فوائد استخدام OpenRouter:

• الوصول إلى نماذج Perplexity دون الحاجة إلى اشتراك مباشر في Pro من Perplexity.
• فواتير موحدة لعدة LLMs من مزودين مختلفين.
• مفتاح واجهة برمجة التطبيقات ونقطة نهاية واحدة لموديلات متنوعة.

اعتبارات:

• قد تختلف الأسعار عن تكاليف API المباشرة من Perplexity.
• قد توجد احتمالات لزيادة زمن الانتظار قليلاً بسبب التفاعل الإضافي.
• اعتماد على توفر منصة OpenRouter وتكاملها مع Perplexity.

خاتمة

يوفر هذا الدليل دليلًا تفصيليًا للوصول إلى النماذج القوية خلف Perplexity AI من خلال طرق واجهة برمجة التطبيقات المختلفة. تذكر أن تستشير دائمًا الوثائق الرسمية لـ Perplexity وOpenRouter للحصول على أحدث أسماء النماذج ونقاط النهاية والأسعار والميزات. قم بتأمين مفاتيح واجهة برمجة التطبيقات الخاصة بك واختر طريقة الوصول التي تناسب متطلبات مشروعك وميزانيتك بشكل أفضل.