طريقة استخدام واجهة برمجة التطبيقات API الخاص بـ ChatGPT

بعد إصدار واجهة برمجة التطبيقات (API)، فتحت OpenAI نموذجها ChatGPT للجميع. يمكنك الآن بسهولة دمج وظائف ChatGPT في مشاريع مختلفة. يعد استخدام واجهات برمجة التطبيقات خطوة مهمة في تسخير قوة التعلم الآلي في تطبيقاتك ومواقعك الإلكترونية. تسمح لك هذه الواجهة بدمج ميزات اللغة الرائعة لـ ChatGPT بسهولة في تطبيقاتك.

دعونا نلقي نظرة فاحصة على طريقة استخدام واجهة برمجة التطبيقات “API” لـ ChatGPT بفعالية وكفاءة. هدفنا هو تقديم إرشادات مفصلة ومفيدة لمساعدة المطورين والمستخدمين على تحقيق أقصى استفادة من ChatGPT API.

كيفية استخدام واجهة برمجة التطبيقات لـ ChatGPT

سواء كنت تريد دمج ChatGPT في تطبيق موجود أو تطوير تطبيق جديد باستخدام ChatGPT، اتبع هذه الخطوات للبدء:

أولا، احصل على مفتاح OpenAI API

لبدء استخدام واجهة برمجة التطبيقات “API” لـ ChatGPT، تحتاج إلى الحصول على مفتاح API.

1. قم بالتسجيل أو تسجيل الدخول إلى حسابك على منصة OpenAI الرسمية.
2. بمجرد تسجيل الدخول، انقر فوق علامة التبويب API Keys في الشريط الجانبي.
3. بعد ذلك، انقر فوق الزر “إنشاء مفتاح خاص جديد” لإنشاء مفتاح API الخاص بك.
4. انسخ مفتاح API الخاص بك وقم بتخزينه في مكان آمن، حيث لن تتمكن بعد الآن من مشاهدته.

الكود المستخدم في هذا المشروع متاح في مستودع GitHub ويمكن استخدامه مجانًا بموجب ترخيص MIT.

ثانيًا، خلق بيئة التطوير

يمكنك استخدام نقاط نهاية واجهة برمجة التطبيقات مباشرة أو استخدام مكتبة openai بايثون/جافا سكريبت لبدء إنشاء التطبيقات بناءً على ChatGPT API. يستخدم هذا البرنامج التعليمي لغة بايثون ومكتبة openai-بايثون.

أتبع الخطوات التالية:

• يمكنك البدء بإنشاء بيئة بايثون افتراضية.
• قم بتثبيت مكتبات openai و python-dotenv باستخدام النقطة.

pip install openai python-dotenv

• لتخزين مفتاح API الخاص بك بشكل آمن، قم بإنشاء ملف.env في دليل مشروعك الرئيسي.
• ثم، في نفس الملف، قم بتعيين المتغير OPENAI_API_KEY على قيمة المفتاح التي نسختها سابقًا.

OPENAI_API_KEY="YOUR_API_KEY"

تنبيه قضائي. احرص على عدم تسريب مفتاح API الخاص بك عن طريق الخطأ من خلال التحكم في الإصدار. أضف ملف.gitignore إلى الدليل الرئيسي لمشروعك وألحق به “.env” لتجاهل ملف dotenv.

ثالثًا، أرسل طلب واجهة برمجة التطبيقات API لـ  ChatGPT

نماذج GPT-3.5 Turbo وGPT-4 وGPT-4 Turbo OpenAI API هي نفسها التي يستخدمها ChatGPT. يمكن لهذه النماذج القوية فهم وإنشاء النصوص والتعليمات البرمجية باستخدام اللغة الطبيعية. يمكن لـ GPT-4 Turbo أيضًا معالجة الصور المدخلة وتوفير وظائف لمجموعة متنوعة من الأغراض، بما في ذلك تحليل الصور وتحليل المستندات باستخدام الأشكال ونسخ النص من الصور.

لاحظ أن ChatGPT API هو اسم عام لواجهات برمجة تطبيقات OpenAI التي تستخدم النماذج المستندة إلى GPT، بما في ذلك نماذج gpt-3.5-turbo وgpt-4 وgpt-4-turbo.

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

ملحوظة. للوصول إلى واجهة برمجة تطبيقات GPT-4، يجب عليك إكمال دفعة بقيمة 1 دولار أو أكثر. وإلا، فقد تتلقى رسالة خطأ مشابهة لما يلي: “النموذج `gpt-4` غير موجود أو ليس لديك الإذن بالوصول إليه.”

طريقة استخدام واجهة برمجة التطبيقات (API) لـ ChatGPT  لإكمال الدردشة

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

from openai import OpenAI
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
response = client.chat.completions.create(
  model = "gpt-3.5-turbo-0125",
  temperature = 0.8,
  max_tokens = 3000,
  response_format={ "type": "json_object" },
  messages = [
    {"role": "system", "content": "You are a funny comedian who tells dad jokes. The output should be in JSON format."},
    {"role": "user", "content": "Write a dad joke related to numbers."},
    {"role": "assistant", "content": "Q: How do you make 7 even? A: Take away the s."},
    {"role": "user", "content": "Write one related to programmers."}
  ]
)

ترسل واجهة برمجة تطبيقات ChatGPT الردود بالتنسيق التالي:

كما يمكنك استخراج محتوى الاستجابة كسلسلة JSON باستخدام الكود التالي.

print(response.choices[0].message.content)

تشغيل هذا الكود يعطي النتيجة التالية:

يوضح هذا الرمز طريقة استدعاء واجهة برمجة التطبيقات “API” لـ ChatGPT باستخدام بايثون. لاحظ أن النموذج يفهم السياق (Dad Joke) ونوع الاستجابة المتوقعة (نموذج الأسئلة والأجوبة) بناءً على الإشارات المقدمة.

الجزء الأكثر أهمية في التكوين هو معلمة الرسالة، التي تقبل مجموعة من كائنات الرسالة. كل كائن رسالة له دور ومحتوى. تتوفر ثلاثة أنواع من الأدوار:

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

كما يمكنك أيضًا ضبط درجة الحرارة (عامل تحكم يستخدم لتغيير سلوك النموذج) ومعلمات نموذج max_tokens للحصول على مخرجات مخصصة وفقًا لمتطلباتك.

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

مثل ChatGPT، لدى واجهة برمجة التطبيقات (API) أيضًا عدد محدود من الكلمات. استخدم المعلمة max_tokens لتحديد طول الاستجابة. لاحظ أن تعيين max_tokens على قيمة منخفضة قد يسبب مشاكل، حيث قد يتم قطع الإخراج.

حتى كتابة هذه السطور، فإن نموذج gpt-3.5-turbo له حد رمزي قدره 4096 وgpt-4 لديه حد رمزي قدره 8192. أحدث الموديلات gpt-3.5-turbo-0125 وgpt-4-turbo-preview لها حدود تبلغ 16,385 و128,000 على التوالي.

نظرًا للطلب الكبير من المطورين، قدمت OpenAI وضع JSON، الذي يخبر النماذج بإرجاع كائنات JSON دائمًا. لتمكين وضع JSON، قم بتعيين Response_format على { “type”: “json_object” }. حاليًا، هذه الميزة متاحة فقط في أحدث الموديلات gpt-3.5-turbo-0125 وgpt-4-turbo-preview.

كما يمكنك أيضًا ضبط النموذج الخاص بك باستخدام المعلمات الأخرى التي توفرها OpenAI.

طريقة استخدام واجهة برمجة التطبيقات (API) لـ ChatGPT  لإكمال النص

بالإضافة إلى مهام الدردشة متعددة التمريرات، تقوم واجهة واجهة برمجة التطبيقات “API” لـ ChatGPT أيضًا بإكمال النص بشكل جيد. يوضح المثال التالي طريقة تكوين ChatGPT API لإكمال النص.

from openai import OpenAI
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
response = client.chat.completions.create(
  model = "gpt-3.5-turbo",
  temperature = 0.8,
  max_tokens = 3000,
  messages = [
    {"role": "system", "content": "You are a poet who creates poems that evoke emotions."},
    {"role": "user", "content": "Write a short poem for programmers."}
  ]
)
print(response.choices[0].message.content)

لا تحتاج حتى إلى تحديد دور النظام أو محتواه. كل ما عليك فعله هو تقديم تلميحاتك المخصصة وسوف يقوم بكل العمل نيابةً عنك.

messages = [
  {"role": "user", "content": "Write a short poem for programmers."}
]

سيؤدي تشغيل الكود أعلاه إلى إنشاء الكود التالي للمبرمجين:

أسعار واجهة برمجة التطبيقات (API) لـ ChatGPT

يعتمد تسعير ChatGPT API على نموذج لكل 1000 رمز مميز. بالنسبة لطلبات الدردشة النهائية، يتم حساب التكلفة بناءً على عدد رموز الإدخال وعدد رموز الإخراج التي يتم إرجاعها بواسطة واجهة برمجة التطبيقات. في مصطلحات الشخص العادي، الرمز يساوي جزءًا من الكلمة، و1000 رمز يساوي حوالي 750 كلمة.

يرجى ملاحظة أن الأسعار قد تتغير بسبب تحسينات النموذج. تحقق الآن من أفضل 5 بدائل قوية وحديثة لـ ChatGPT في عام 2024