دليلك الكامل لاستخدام ChatGPT API لأول مرة — من الصفر للاحتراف

المستوى: مبتدئ

وقت القراءة: 12 دقيقة

ما ستتعلمه: إنشاء مفتاح API، أول طلب، فهم الأسعار، بناء chatbot بسيط

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

الخطوة 1: إنشاء حساب OpenAI والحصول على API Key

اذهب إلى platform.openai.com وأنشئ حساباً مجانياً. بعد تسجيل الدخول:

  1. اضغط على اسمك في الزاوية اليمنى العلوية
  2. اختر «API Keys»
  3. اضغط «Create new secret key»
  4. احفظ المفتاح فوراً — لن تراه مرة ثانية!

تحذير مهم: لا تشارك مفتاح الـAPI مع أحد، ولا تضعه في كود على GitHub عام. إنه مثل كلمة السر تماماً.

الخطوة 2: فهم نظام الأسعار

الدفع في OpenAI API يعتمد على الـtokens. الـtoken الواحد = تقريباً 4 أحرف إنجليزية أو كلمة عربية واحدة.

  • GPT-4o Mini: 0.15 دولار لكل مليون input token — الأرخص والأسرع للمشاريع الصغيرة
  • GPT-4o: 2.5 دولار لكل مليون input token — للمهام التي تتطلب دقة عالية
  • GPT-4.1: 2 دولار لكل مليون input token — توازن ممتاز بين الأداء والسعر

للمشاريع التجريبية، ابدأ دائماً بـGPT-4o Mini. محفظة 5 دولار تكفيك لآلاف الطلبات.

الخطوة 3: أول طلب بـ Python

افتح تيرمينال وثبّت المكتبة:

pip install openai

أنشئ ملف test_api.py:

from openai import OpenAI

client = OpenAI(api_key="sk-YOUR-KEY-HERE")

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "system", "content": "أنت مساعد ذكي يتحدث العربية بطلاقة."},
        {"role": "user", "content": "اشرح لي مفهوم الذكاء الاصطناعي في 3 جمل."}
    ]
)

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

شغّل الملف:

python test_api.py

مبروك! أرسلت أول طلب لـChatGPT API.

الخطوة 4: فهم بنية الـ API

كل طلب يتكوّن من ثلاثة عناصر أساسية:

  • system: التعليمات الدائمة للنموذج — شخصيته، حدوده، أسلوبه
  • user: رسالة المستخدم
  • assistant: ردود النموذج السابقة (لبناء محادثة متسلسلة)

الخطوة 5: بناء Chatbot بسيط

from openai import OpenAI

client = OpenAI(api_key="sk-YOUR-KEY-HERE")
history = [{"role": "system", "content": "أنت مساعد ودود يتحدث العربية."}]

print("المساعد جاهز! اكتب 'خروج' للإنهاء.
")

while True:
    user_input = input("أنت: ")
    if user_input == "خروج":
        break

    history.append({"role": "user", "content": user_input})

    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=history
    )

    reply = response.choices[0].message.content
    history.append({"role": "assistant", "content": reply})
    print(f"
المساعد: {reply}
")

هذا الكود يحفظ تاريخ المحادثة، لذلك النموذج «يتذكر» ما قلته سابقاً في نفس الجلسة.

نصائح للمبتدئين

  • ابدأ دائماً بـGPT-4o Mini وانتقل للنماذج الأقوى فقط عند الحاجة
  • ضع حداً أقصى لعدد الـtokens باستخدام max_tokens=500 لتفادي الرسوم الزائدة
  • استخدم متغيرات بيئة (environment variables) لحفظ مفتاح الـAPI بأمان
  • راقب استهلاكك من لوحة dashboard.openai.com

جرّب بنفسك

الخطوة التالية: اقرأ التوثيق الرسمي على platform.openai.com/docs، وجرّب بناء أداة بسيطة تحلّ مشكلة حقيقية في حياتك. الفكرة الأفضل دائماً هي التي تحلّ مشكلتك الشخصية أولاً.

شاهد أيضاً

GitHub Copilot — ازاي الـ AI بيكتب كود بدالك

تخيل إنك بتكتب كود والبرنامج بيكمّل السطر بدالك — ومش بس كلمة، لا أسطر كاملة. …

اترك تعليقاً

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *