اشتراكات الذكاء الاصطناعي ومفاتيح API: دليل خطوة بخطوة

ابدأ بالمصطلحات

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

1. الاشتراك وAPI وبطاقة الويب أشياء مختلفة

تتيح API للبرنامج طلب عمل من خدمة ذكاء اصطناعي. المفتاح بيانات اعتماد سرية تسمح باستخدام حسابك. وهو مختلف عن رمز دخول البريد، ومفتاح استرداد Quiz Notebook، وكلمة مرور المحادثة.

فوترة المحادثة وAPI منفصلتان حتى مع البريد نفسه. لا يلزم شراء اشتراك محادثة مدفوع أولًا لاستخدام API. راجع إعدادات فوترة حساب API.

2. اختر طريقة العمل

يمكنك العمل يدويًا في تطبيق المحادثة المعتاد، ومراجعة النتيجة ثم استيرادها بصيغة مدعومة. هذا مسار منفصل عن ربط API.

في BYOK تدير مفتاحك والنموذج والتكلفة بنفسك. يدعم هذا الربط OpenAI وAnthropic مباشرة. بيانات Gemini وNotebookLM وAzure وBedrock لا تصلح لهذه الحقول.

لطلب مجموعة جاهزة لا ترسل مفتاحك الشخصي. تشمل الخدمة فحص الملاءمة، والاتفاق على النطاق، والمراجعة والتسليم. راجع صفحة الخدمة لمعرفة بدء استقبال الطلبات المدفوعة.

3. قبل الربط

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

يتطلب تطبيق الويب الدخول بالبريد، وبطاقة استخدام سارية، وجهازًا مسجلًا ونشطًا في إعدادات الحساب. إنشاء مفتاح لا يفتح ميزة غير متاحة بعد.

لا تكتب المفتاح في هذا الدليل أو نموذج تواصل أو بريد. استخدم الحقل المخفي في تطبيق الويب الرسمي فقط.

4. إنشاء مفتاح OpenAI

1. سجّل الدخول إلى OpenAI API Platform، المنفصلة عن إعدادات اشتراك ChatGPT.
2. أنشئ أو اختر مشروعًا مخصصًا لـQuiz Notebook ضمن مؤسستك لتسهيل تتبع التكلفة وإلغاء المفتاح.
3. راجع API Billing ووسيلة الدفع والرصيد. عطّل Auto-reload واحفظ الإعداد إذا لم ترغب في شراء رصيد تلقائيًا.
4. من API Keys في المشروع أنشئ مفتاحًا سريًا جديدًا باسم واضح، واحفظه في مدير كلمات مرور آمن.
5. امنح الصلاحيات المطلوبة فقط قدر الإمكان. يحتاج الربط إلى إنشاء طلبات Responses API؛ صلاحية Read Only لا تكفي. لا تستخدم مفتاح إدارة.
6. ابحث عن معرّف نموذج API الدقيق في الوثائق وتحقق من إتاحته للمشروع. اسم الاشتراك أو الاسم المعروض في المحادثة ليس معرّف النموذج.

إذا فقدت السر، أنشئ بديلًا وألغِ المفتاح القديم. يجب أن تكون الفوترة وصلاحيات المشروع والنموذج صالحة أيضًا.

5. إنشاء مفتاح Claude / Anthropic

1. ادخل إلى Claude Console، المنفصلة عن إعدادات Claude Pro أو Max.
2. اختر المؤسسة ومساحة العمل، واضبط API Billing وراجع خيارات الشحن وحدود الإنفاق المتاحة.
3. أنشئ مفتاح استدلال في API Keys. استخدم مفتاحًا لمساحة عمل واحدة، وليس مفتاح إدارة أو بيانات اعتماد لسحابة أخرى.
4. راجع الاسم والصلاحيات والانتهاء، واحفظ السر بأمان وسجّل مساحة العمل التي ستراقب استهلاكها.
5. اختر معرّف نموذج متاح من الوثائق، ثم اختر Anthropic في Quiz Notebook.

اشتراك Claude المدفوع لا يحل محل رصيد API أو إعداد فوترة Console.

6. الربط داخل Quiz Notebook

1. ادخل إلى التطبيق الرسمي وتحقق من بطاقة الاستخدام والجهاز النشط في الإعدادات.
2. اختر مجموعة بطاقات. ابدأ بسؤال وجواب أو اثنين قصيرين من كتابتك.
3. افتح ‘내 API로 AI 후보 만들기’ (إنشاء مقترحات باستخدام API الخاص بي) أسفل المجموعة. الحقل ليس داخل إعدادات الحساب.
4. اختر OpenAI أو Anthropic، وأدخل معرّف النموذج الدقيق والمفتاح في ‘본인 API 키’. أزل المسافات والأسطر الزائدة.
5. اقرأ إشعار الإرسال والتكلفة المنفصلة ووافق عليه. يُرسل نص الأسئلة والأجوبة للمجموعة؛ لا تُقرأ الصور والمرفقات تلقائيًا.
6. اضغط مرة واحدة ‘별도 후보 덱 만들기’ (إنشاء مجموعة مقترحات منفصلة) وانتظر. إدخال المفتاح وحده لا يستدعي الذكاء الاصطناعي.
7. راجع المجموعة المنفصلة مقابل المصدر من حيث الصحة والشرح والحقوق. لا تُدمج تلقائيًا مع الأصل ولا تمر بمراجعة خدمة الإنتاج حسب الطلب.
8. راجع Usage وBilling لدى المزوّد قبل زيادة حجم المواد.

7. أين يذهب المفتاح والمحتوى؟

المسار هو المتصفح ← ثم خادم Quiz Notebook ← ثم مزوّد الذكاء الاصطناعي المختار، وتعود النتيجة إلى المتصفح. يتعامل الخادم مؤقتًا مع المفتاح في الذاكرة؛ ليس اتصالًا مباشرًا حصريًا بين المتصفح والمزوّد.

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

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

8. إدارة التكلفة

تعتمد التكلفة على النموذج ورموز الإدخال والإخراج وعدد الطلبات. الرمز ليس حرفًا بالضرورة. قد تزيد التكلفة مع طول المصدر والجواب وتكرار الطلبات.

قدّر رموز الإدخال × سعر الإدخال + رموز الإخراج × سعر الإخراج وفق وحدات جدول السعر الرسمي. راجع شروط التخزين المؤقت والاستدلال والضرائب وتحويل العملة. بطاقة الويب تكلفة منفصلة.

تنبيهات OpenAI لا توقف الطلبات. راجع واحفظ ‘Enforce a hard limit’ ضمن Limits إذا أردت فرض الحد. قد يسمح تأخر التطبيق بتجاوز صغير. حد الشحن التلقائي يضبط شراء الرصيد، لا إنفاق API نفسه.

في Claude Console راجع استهلاك المؤسسة أو مساحة العمل والفوترة. ابدأ بكمية صغيرة وافحص التنبيهات والحدود والشحن كلًا على حدة.

9. الفصل أو الاستبدال أو الإلغاء

1. زر ‘입력한 API 키 지우기’ (مسح المفتاح المُدخل) يمحو المفتاح والموافقة من الشاشة. لا يلغي طلبًا قيد التنفيذ.
2. لمنع الاستخدام المستقبلي في أماكن أخرى، ألغِ أو احذف المفتاح من API Keys لدى المزوّد. تفريغ الحقل لا يلغيه.
3. أعد الربط بمفتاح جديد. إذا اشتبهت بتسريب، ألغِ القديم أولًا وافحص Usage وBilling لأي نشاط غير معروف.
4. أدر اشتراك المحادثة وشحن API وبطاقة Quiz Notebook منفصلة. إلغاء أحدها لا يلغي البقية.

للدعم أرسل الوقت والمزوّد ومعرّف النموذج ولقطة خطأ تخفي الأسرار. لا ترسل المفتاح كاملًا أبدًا.

10. معالجة المشكلات

زر معطل: راجع الإتاحة والدخول والبطاقة والموافقة وأي طلب جارٍ. عند خطأ الجهاز راجع التسجيل والتفعيل.

خطأ مفتاح أو نموذج: راجع المزوّد والمسافات والانتهاء والإلغاء والصلاحيات والمعرّف الدقيق. دفع اشتراك المحادثة لا يشحن API.

نفاد حصة أو ازدحام: راجع الرصيد وحدود السرعة والإنفاق. قد يتأخر ظهور رصيد جديد؛ لا تكرر الشراء قبل فهم السبب.

انتهاء مهلة أو صيغة غير صالحة: لا توجد إعادة محاولة تلقائية. ربما أنجز المزوّد عملًا قابلًا للفوترة. راجع Usage قبل الإعادة بنص أقصر.

محتوى خاطئ: نجاح الاتصال لا يثبت صحة الأجوبة. صحح المقترحات غير المسندة أو احذفها.

11. المشاركة والحقوق والمؤسسات

لا تشارك المفاتيح مع الأصدقاء أو الطلاب؛ قد تُحمّل الطلبات على الحساب نفسه. يتطلب تجهيز خدمة مؤسسية اتفاقًا على ملكية الحساب والصلاحيات والتكاليف. لا ترفق مفاتيح أو بيانات طلاب حقيقية بطلب الاستفسار.

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

مفتاح API يجيز طلبات الذكاء الاصطناعي؛ رمز البريد يثبت الدخول؛ مفتاح الاسترداد يفتح المجموعات المشفرة. لا يمكن استبدال أحدها بالآخر.

12. أسئلة شائعة

هل إدخال المفتاح يسبب رسومًا؟ الإدخال وحده لا يرسل طلبًا. قد تُحسب رسوم عندما يعالج المزوّد طلب الإنشاء.

هل النتيجة مطابقة للمحادثة؟ قد تختلف النماذج والتعليمات والإعدادات والأدوات. البحث والمرفقات في المحادثة لا تُضاف تلقائيًا.

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

هل توجد القائمة نفسها في التطبيقات المثبتة؟ هذا دليل الويب. راجع دليل إصدار الجهاز اللوحي أو سطح المكتب لمعرفة مساره وحالة إتاحته.