كيف تحصل على ChatGPT API key وتضبط استخدامه بأمان؟

1. سجّل الدخول واختر المشروع المناسب

افتح platform.openai.com وأنشئ حسابًا أو سجّل الدخول. أكمل خطوات الإعداد التي تظهر لك. ويتضمن دليل البدء السريع من OpenAI رابطًا مباشرًا إلى لوحة مفاتيح API.

تخيّل أن حسابك هو بطاقة الموظف، وأن المؤسسة هي الشركة، وأن المشروع غرفة مخصصة لتطبيق واحد. أما المفتاح فهو بيانات الاعتماد التي يستخدمها برنامجك لدخول تلك الغرفة.

اختر المؤسسة المطلوبة من قائمة تبديل المؤسسات. ثم اختر مشروعًا قائمًا، أو استخدم خيار إنشاء مشروع (Create project) من قائمة المشاريع إذا كنت مالك المؤسسة، وأكمل بياناته. اسم واضح مثل website-test يبيّن الغرض من المشروع. يشرح دليل المشاريع من OpenAI هذه الخيارات.

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

2. أنشئ ChatGPT API key داخل المشروع

من إعدادات المؤسسة، اختر مشروعك وافتح مفاتيح API (API Keys)، ثم اختر إنشاء مفتاح سري جديد (+ Create new secret key). سينشأ مفتاح مرتبط بالمشروع المحدد. راجع تعليمات إنشاء مفتاح المشروع.

لتجربتك الشخصية الأولى، استخدم مفتاح مشروع مملوكًا لمستخدم. إذا طُلب منك اسم، فاختر اسمًا يسهل تمييزه مثل local-test. اختر صلاحيات مقيّدة (Restricted) وفعّل العمليات التي يحتاج إليها تطبيقك. يمنح خيار الكل (All) صلاحية وصول كاملة، وهو الخيار الافتراضي؛ أما للقراءة فقط (Read Only) فيحصر استخدام المفتاح في عمليات القراءة. راجع صلاحيات مفاتيح API. لتنفيذ الاختبار أدناه، اسمح بإنشاء الاستجابات عبر Responses؛ وتسمّي OpenAI هذه الصلاحية api.responses.write. راجع صلاحية إنشاء الاستجابات.

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

حدّد تاريخ انتهاء للمفتاح وسجّل اسم المسؤول عن استبداله. قد تفرض سياسة المؤسسة تاريخ انتهاء أو تقيّد أنواع المفاتيح التي يمكنك إنشاؤها. إذا لم تجد أحد الخيارات، فاسأل المسؤول عن السياسة المعمول بها. راجع إرشادات OpenAI للتشغيل في بيئة الإنتاج. واستعن بـخطة انتهاء صلاحية مفتاح API وتدويره قبل أن تتحول التجربة إلى خدمة تعمل باستمرار.

متى يكون مفتاح حساب الخدمة أنسب؟

لتطبيق منشور أو سير عمل مجدول يستخدمه الفريق، أفضّل حساب خدمة: هوية للبرنامج بدلًا من هوية شخص. ينشئه مالك المؤسسة أو المشروع من داخل المشروع المحدد، عبر الأعضاء ثم إضافة حساب خدمة (Members → + Service account). احفظ المفتاح الناتج فورًا. واستخدم مشروعًا مخصصًا؛ إذ لا يمكن إضافة حسابات الخدمة مباشرة إلى المشروع الافتراضي Default. راجع إعداد حساب الخدمة.

بعد الإنشاء، راجع صلاحياته في إعدادات مفاتيح API (API Keys) الخاصة بالمشروع. لا تعرض نافذة إنشاء حساب الخدمة خيارات الصلاحيات نفسها التي يتيحها إنشاء مفتاح مملوك لمستخدم. راجع الفروق في الصلاحيات. الفائدة التشغيلية هنا هي بقاء المسؤولية عن بيانات اعتماد التطبيق واضحة حتى مع تغيّر أعضاء الفريق.

3. فعّل فوترة API وحدّد سقف الإنفاق

فوترة ChatGPT منفصلة عن فوترة API. الدفع مقابل ChatGPT لا يُكمل إعداد الدفع لاستخدام API. افتح صفحة فوترة API للمؤسسة المقصودة؛ ويستطيع مالك المؤسسة إدارة فوترتها. راجع إرشادات الفوترة من OpenAI.

تستخدم حسابات API الجديدة الفوترة مسبقة الدفع. اختر إضافة بيانات الدفع (Add payment details)، وأكمل الإعداد، ثم حدّد الرصيد الذي ستشتريه أول مرة وأكّد العملية. راجع خيار إعادة الشحن التلقائي (Use auto-reload) قبل الدفع؛ فبحسب OpenAI، يكون مفعّلًا افتراضيًا. عطّله إذا أردت تجربة تعتمد على الشحن اليدوي، أو اضبط عن قصد عتبة تفعيله والحد الشهري لإعادة الشحن. قد يستغرق ظهور الرصيد المشترى بضع دقائق. راجع إعداد الفوترة مسبقة الدفع.

لمعرفة أسعار النماذج الحالية، راجع صفحة أسعار OpenAI، واستعن بـدليل أسعار OpenAI API على الموقع لتقدير ميزانية التطبيق.

كيف تجعل الطلبات تتوقف عند بلوغ سقف الإنفاق؟

انتقل بالترتيب إلى إعدادات المشروع ثم الحدود ثم الإنفاق ثم تعديل حد الإنفاق (Project settings → Limits → Spend → Edit spend limit). أدخل حد الإنفاق الشهري (Monthly spend limit)، وفعّل فرض حد صارم (Enforce a hard limit)، ثم احفظ. تحتاج إلى صلاحية إدارة إعدادات ذلك المشروع. أضف تنبيه إنفاق عند مبلغ أقل من السقف، ليتمكن المسؤول من التدخل قبل توقف الخدمة. راجع تعليمات حد الإنفاق.

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

قبل الإطلاق في بيئة الإنتاج، اقرأ دليل حدود الإنفاق الصارمة في OpenAI API، وحدّد من يملك صلاحية رفع السقف إذا أدى إلى انقطاع الخدمة.

4. احفظ المفتاح حيث يستخدمه التطبيق بأمان

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

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

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

5. اختبر الاتصال بطلب curl واحد

شغّل الأوامر التالية في Bash على جهازك. الأداة curl ترسل طلبات الويب من سطر الأوامر. تطلب الأسطر الأولى إدخال المفتاح السري من دون عرضه أو كتابة قيمته مباشرة ضمن الأمر الذي تدخله؛ ويظل متغير البيئة متاحًا طوال جلسة مفسّر الأوامر الحالية.

read -r -s -p "OpenAI API key: " OPENAI_API_KEY
printf '\n'
export OPENAI_API_KEY

curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-6-astra",
    "input": "Reply with a short greeting."
  }'

يستخدم هذا الطلب البنية والنموذج الواردين في مثال توليد النصوص من OpenAI. تستقبل نقطة النهاية Responses API مدخلاتك وتعيد مخرجات النموذج. تحمل ترويسة التفويض المفتاح السري، فيما يحدّد جسم الطلب بصيغة JSON النموذج والتعليمات. هذا طلب لاستخدام API، لذلك يجب أن تكون الفوترة وإمكانية الوصول إلى النموذج جاهزتين.

تتضمن الاستجابة الناجحة مصفوفة output، وفيها رسالة تحتوي على محتوى من نوع output_text. ابحث عن التحية هناك. لا تفترض أن النص هو العنصر الأول دائمًا في المصفوفة. وإذا ظهر كائن error، فاستعن برسالته ورمزه وبالإرشادات أدناه. راجع بنية الاستجابة.

بعد الاختبار، نفّذ unset OPENAI_API_KEY لمسح المتغير من جلسة مفسّر الأوامر عندما لا تعود بحاجة إليه. وعند نشر التطبيق، اضبط المفتاح السري في بيئة الاستضافة بدلًا من إعادة إدخاله عبر الطرفية.

مفتاح OpenAI API لا يعمل؟ ابدأ بهذه الفحوص

اقرأ رسالة الخطأ قبل إنشاء مفتاح آخر؛ فكثير من الأعطال لا يتعلق بالمفتاح السري نفسه.

قد تعني الاستجابة 429 مشكلة في الإنفاق أو الرصيد، وقد تعني بلوغ حد معدل الطلبات. تكرار المحاولة لا يضيف رصيدًا ولا يغيّر سقفًا مضبوطًا مسبقًا. راجع رموز أخطاء OpenAI وصلاحيات المفاتيح.

إذا تسرّب مفتاح API، فألغِه فورًا

تعامل مع أي مفتاح سري نُشر في مستودع عام أو لقطة شاشة أو رسالة على أنه مكشوف. حذف النسخة الظاهرة لا يُبطل النسخ التي ربما حصل عليها أحد بالفعل.

1. ألغِ المفتاح المكشوف. افتح صفحة مفاتيح API داخل المشروع الصحيح واحذفه. قد تتوقف التطبيقات التي تستخدمه إلى أن تستبدله. راجع حذف المفاتيح.
2. أنشئ بديلًا وحدّث التطبيقات المتأثرة. اختبر المفتاح البديل، ثم تأكد من أن العمليات المنشورة تستخدمه.
3. راجع الاستخدام والفوترة. تحرَّ الطلبات غير المتوقعة وتواصل مع دعم OpenAI عند الاشتباه في إساءة استخدام. توصي OpenAI بتدوير المفتاح فور الاشتباه في تسرّبه. راجع إرشادات التعامل مع التسرّب.
4. عالج سبب التسرّب. أزل المفتاح السري من الشفرة والسجلات، وصحّح طريقة التخزين أو المشاركة التي أدت إلى كشفه. وإذا احتُمل اختراق الحساب نفسه، فغيّر كلمة المرور، وسجّل الخروج من الجلسات الأخرى، وأبلغ عن النشاط غير المصرح به. راجع خطوات استعادة أمان الحساب.

خمس حالات تستفيد فيها من هذا الإعداد

الفائدة هي ربط واضح المسؤولية والميزانية. هذه أمثلة عملية يمكن للفريق تطبيق الإعداد فيها، مرتبة بحسب فائدتها المباشرة.

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

فكرتان مفيدتان يمكن بناؤهما حول هذا الإعداد

الفرصة الأقوى هي مساعد ربط مدمج في البرامج التي تطلب من عملائها مفتاح OpenAI. تقدّر DataForSEO وجود 1,000 عملية بحث شهرية في الولايات المتحدة عن عبارة “how to get openai api key”. هذا مؤشر على صعوبة الإعداد، وليس توقعًا لعدد العملاء الذين سيدفعون. يمكن لمزود أداة شراء أو بناء قائمة إرشادية لإعداد المشروع، وحقل آمن لبيانات الاعتماد، وزر اختبار واضح، ونتيجة مفهومة. ينبغي أن تكون أبسط نسخة داخل المنتج الذي يحتاج إلى الربط. أما التحدي، فهو أن المزودين يستطيعون بناء ذلك بأنفسهم؛ لذا يجب أن تأتي القيمة من تقليل عبء الدعم وتحديث التعليمات باستمرار.

شرح الأخطاء ميزة مفيدة للدعم، لكن الطلب عليها كمنتج مستقل أضعف. يقدّر الفحص نفسه وجود 10 عمليات بحث شهرية في الولايات المتحدة فقط عن عبارة “openai api key not working”. يمكن لمزود أدوات أتمتة أو وكالة تنفيذ تقديم نموذج يستقبل رمز الخطأ ورسالته بعد حجب المعلومات الحساسة، ثم يوضح ما إذا كان الحل يتعلق ببيانات الاعتماد أو الرصيد أو الصلاحيات أو وتيرة الطلبات. تحتاج نسخته الأولى إلى جدول قرارات يُحدَّث باستمرار، لا إلى الاحتفاظ بمفتاح المستخدم. التحدي هو ضآلة حجم البحث المقاس، وأن أدوات كثيرة تعرض هذه الأخطاء أصلًا. لذلك أفضّل إلحاقه بخطوات الإعداد الأولي بدلًا من إطلاقه منتجًا مدفوعًا مستقلًا.

هذه تقديرات DataForSEO من فحص نظرة عامة على الكلمات المفتاحية باللغة الإنجليزية في الولايات المتحدة، أُجري لهذا الدليل. وهي تقيس عمليات البحث، لا المستخدمين الفريدين ولا نية الشراء.

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

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