طريقة مصادقة واجتياز الواجهة البرمجية للتطبيقات

1. تعليمات مصادقة واجهة برمجة تطبيقات OpenAI

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

2. الحصول على مفتاح API لـ OpenAI

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

3. إضافة مفتاح الـ API في رأس الطلب HTTP

عند إجراء طلبات API إلى OpenAI، تحتاج إلى إضافة حقل "Authorization" في رأس طلب HTTP، وقيمته "Bearer" متبوعة بمفتاح الـ API الخاص بك. فيما يلي مثال على إرسال طلب باستخدام أمر curl:

curl "https://api.openai.com/v1/endpoint" \
  -H "Authorization: Bearer OPENAI_API_KEY"

يرجى استبدال "OPENAI_API_KEY" بمفتاح الـ API الفعلي الخاص بك.

4. استخدام مفاتيح الـ API لعدة أعضاء في المؤسسة

إذا كنت عضوًا في عدة مؤسسات وترغب في تحديد أي من إحصاءات الاستخدام يجب أن تنسب طلبات الـ API إليه، يمكنك حمل حقل آخر "OpenAI-Organization" في رأس طلب HTTP. قيمة هذا الحقل يجب أن تكون ID المؤسسة التي ترغب في تنسيب إحصاءات الاستخدام إليها.

فيما يلي مثال على أمر curl يحدد رقم المؤسسة:

curl "https://api.openai.com/v1/endpoint" \
  -H "Authorization: Bearer OPENAI_API_KEY" \
  -H "OpenAI-Organization: YOUR_ORG_ID"

يرجى استبدال "OPENAI_API_KEY" و "YOUR_ORG_ID" بمفتاح الـ API ورقم المؤسسة الفعليين الخاصين بك.

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