TL;DR
TypingMind هو واجهة دردشة ذكاء اصطناعي مرنة تتيح لك ربط GPT وClaude وDeepSeek وغيرها من النماذج المدعومة باستخدام مفاتيح API الخاصة بك. من خلال دمج CometAPI عبر اتصال متوافق مع OpenAI، يمكنك الوصول إلى عدة نماذج ذكاء اصطناعي بدون تهيئة حسابات مزودين منفصلة. يوضح هذا الدليل كيفية إضافة نموذج مخصص باستخدام مفتاح CometAPI API ونقطة نهاية Chat Completions، وإرسال رسالتك الأولى، وحل أخطاء الإعداد الشائعة. ستحتاج إلى مفتاح CometAPI API ورصيد متاح في الحساب وإمكانية الوصول إلى إعدادات النماذج المخصصة في TypingMind. ابدأ بموجه نصي أساسي، ثم فعّل القدرات المتقدمة عند الحاجة. يتضمن الدليل مثالًا اختياريًا عبر Bash وcURL لاختبار اتصال API.
Key Takeaways
- مفتاح API واحد، نماذج متعددة: الوصول إلى المزودين المدعومين عبر حساب CometAPI واحد.
- تكامل متوافق مع OpenAI: تهيئة نقطة نهاية Chat Completions قياسية بدون SDK مخصص.
- اختيار نماذج مرن: تسجيل عدة نماذج مدعومة من CometAPI داخل TypingMind.
- فوتر منفصل: يتم احتساب تكلفة الاستدلال عبر CometAPI؛ ترخيص TypingMind منفصل.
ما هو TypingMind
TypingMind هو واجهة دردشة ذكاء اصطناعي تتصل بالنماذج عبر مفاتيح API التي توفرها. يمنحك مكانًا واحدًا لاختيار النماذج وإدارة المحادثات. يوفر TypingMind الواجهة؛ بينما يتولى مزود الـ API المتصل معالجة طلبات النموذج وفوترة الاستخدام.
يوفر CometAPI لـ TypingMind اتصال API مشتركًا للنماذج المدعومة من عدة مزودين، بما في ذلك GPT وClaude وGemini وDeepSeek. يمكنك إدارة الوصول إلى الـ API والفوترة عبر حساب CometAPI واحد، ثم إنشاء إدخالات نماذج مخصصة منفصلة في TypingMind للنماذج التي تريد استخدامها. يسهل ذلك تجربة نماذج مختلفة للكتابة أو البرمجة أو الأسئلة اليومية بدون إعداد حساب API منفصل مع كل مزود.
ما الذي تحتاجه قبل توصيل CometAPI بـ TypingMind؟
أنشئ مفتاحًا عبر قسم API Keys في حساب CometAPI، باتباع إرشادات إنشاء المفتاح. استخدم مفتاحًا مخصصًا لهذا الاتصال حتى تتمكن من إلغائه دون التأثير على عمليات تكامل أخرى. احفظ المفتاح بعيدًا عن لقطات الشاشة والمستندات المشتركة والمستودعات العامة.
يدعم CometAPI عدة عائلات نماذج، بما في ذلك GPT وClaude وGemini وDeepSeek؛ وهو ليس محصورًا في GPT-6 Luna. يستخدم هذا الشرح GPT-6 Luna (معرّف النموذج: gpt-6-luna) فقط كمثال لجدول الإعداد والاختبار في الطرفية. يمكنك اختيار نموذج آخر من كتالوج نماذج CometAPI، بشرط أن يكون حسابك قادرًا على الوصول إليه وأن يدعم مساره OpenAI Chat Completions.
عند استخدام نموذج آخر، استبدل gpt-6-luna بمعرّف ذلك النموذج الدقيق في كل من TypingMind وطلب cURL. حدّث أيضًا اسم العرض وطول السياق والتسعير وإعدادات القدرات لتلائم النموذج المختار. لا ينبغي افتراض أن إعدادات النموذج المثال تنطبق على كل نموذج.
استخدم الإعداد التالي. يحتاج TypingMind إلى عنوان URL كامل لنقطة النهاية؛ عنوان أساس SDK المنتهي بـ /v1 هو حقل مختلف ولا يجب استبداله هنا.
| TypingMind field | Value |
|---|---|
| Name | GPT-6 Luna عبر CometAPI |
| Model ID | gpt-6-luna |
| API type | OpenAI Chat Completions API |
| Endpoint URL | https://api.cometapi.com/v1/chat/completions |
| Authentication | مفتاح API عبر ترويسة HTTP |
| Header key | Authorization |
| Header value | Bearer YOUR_COMETAPI_API_KEY |
كيف تضيف CometAPI إلى TypingMind؟
أنشئ نموذجًا مخصصًا
افتح TypingMind، اختر Models، ثم Add custom model. اترك Create Manually محددة. توثّق عملية الإعداد اليدوي هذه الحقول.
أدخل تفاصيل النموذج
انسخ الاسم ومعرّف النموذج من جدول الإعداد. إذا طُلب Context Length، فاستعمل الحد الموثّق للنموذج المختار؛ نافذة السياق الموثّقة لـ GPT-6 Luna هي 1,050,000 tokens. حدّ السياق إعداد سعة، وليس توصية بإرسال هذا العدد من الرموز.
اضبط نقطة النهاية والمصادقة
ضمن Authentication، أدخل نوع الـ API ونقطة النهاية ومفتاح الترويسة وقيمة الترويسة من الجدول. استبدل YOUR_COMETAPI_API_KEY بمفتاحك الفعلي. ضع مسافة واحدة بعد Bearer وبدون علامات اقتباس.
تأتي لقطتا الشاشة من الدليل الرسمي لـ TypingMind. يوضح نموذج المصادقة الفارغ مواضع الحقول؛ أدخل نقطة نهاية CometAPI الخاصة بك ومعرّف النموذج والمفتاح.
اختبر واحفظ الاتصال
ابدأ بدردشة نصية واترك تجاوزات الطلب الاختيارية غير معيّنة. انقر Test & Save، واختر النموذج المحفوظ، وأرسل: “اشرح REST APIs مقابل WebSockets في ثلاث جمل.” يؤكد رد المساعد المرئي وجود اتصال أساسي. أرسل متابعة للتحقق من استمرار المحادثة.
فعّل القدرات الاختيارية
ابدأ بالدردشة النصية. فعّل البثّ (streaming) والمطالبات النظامية (system prompts) وإدخال الصور والأدوات أو ضوابط الاستدلال فقط عند دعمها. اختبر القدرات المتقدمة بشكل منفصل.
توفر إعدادات Capabilities في TypingMind فحوصات تلقائية وضوابط يدوية. اعتبر الاكتشاف نقطة بداية: تحقق من كل ميزة مع النموذج والمسار المحددين. حافظ على إعداد أساسي يعمل لتتمكن من إزالة آخر تجاوز إذا فشل اختبار ميزة.
كيف تتحقق من طلب CometAPI خارج TypingMind؟
استخدم هذا الاختبار الاختياري عندما يفشل Test & Save. يرسل طلبًا بسيطًا باستخدام نفس المفتاح ومعرّف النموذج، وفق تنسيق طلب Chat Completions الموثّق لدى CometAPI. لا يتطلب تغيير إعداد TypingMind.
عيّن المفتاح لجلسة Bash الحالية
شغّل ما يلي في Bash، بما في ذلك Git Bash أو WSL على Windows. الصق المفتاح عند المطالبة المخفية. هذه الأوامر بصيغة Bash ويجب عدم لصقها في PowerShell دون تغيير.
read -r -s -p "CometAPI API key: " COMETAPI_API_KEYprintf '\n'export COMETAPI_API_KEY
أرسل طلب دردشة بسيطًا
curl --include --silent --show-error \ https://api.cometapi.com/v1/chat/completions \ -H "Authorization: Bearer $COMETAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-luna", "messages": [ {"role": "user", "content": "Explain API gateways in one sentence."} ] }'
تفحّص choices[0].message.content للحصول على نص المساعد. إذا أعاد cURL خطأ HTTP، اقرأ جسم الاستجابة قبل تغيير الإعدادات. إذا نجح بينما فشل TypingMind، فقارن نقطة النهاية والمفتاح ومعرّف النموذج وخيارات التجاوز الاختيارية، ثم تحقق من لوحة الشبكة في المتصفح. يؤكد طلب الطرفية الناجح مسار الطلب؛ لكنه لا يتحقق من الوصول عبر المتصفح أو كل قدرات النموذج.
أزل متغيّر البيئة المؤقت
unset COMETAPI_API_KEY
كيفية استكشاف أخطاء اتصال TypingMind وإصلاحها
استخدم جسم الاستجابة ولوحة الشبكة في المتصفح لتحديد الطلب الذي يفشل. الفحوصات أدناه نقاط بداية، وليست تشخيصًا يعتمد على رمز الحالة وحده. حافظ على سرية بيانات الاعتماد في لقطات الشاشة ورسائل الدعم.
| العرض/العَرَض | الفحص الأول | الإجراء التالي |
|---|---|---|
| 401 Unauthorized | المفتاح وترويسة Authorization | تحقق من مفتاح منتهي أو مُلغى، أو وجود مسافات زائدة، أو غياب بادئة Bearer. |
| 403 Forbidden | جسم الاستجابة ووصول النموذج | أكد أذونات الحساب والوصول إلى المسار المحدد. |
| 404 Not Found | نقطة النهاية ومعرّف النموذج الدقيق | استخدم عنوان /v1/chat/completions الكامل وتحقق من المعرّف في الكتالوج. |
| 400 Bad Request | جسم الطلب والتجاوزات | أزل المعلمات الاختيارية وأعد المحاولة بطلب نصي بسيط. |
| 429 Too Many Requests | تفاصيل حصة الاستخدام أو الإيقاع | تحقق من حدود الحساب والرصيد. أوقف محاولات الإعادة عند الإيقاف المؤقت؛ عالج نفاد الحصة قبل إعادة المحاولة. |
| خطأ شبكة المتصفح | لوحة الشبكة ووحدة التحكم | تحقق من الاتصال وأي خطأ cross-origin مُبلّغ عنه؛ وقارن مع اختبار الطرفية. |
| فشل البثّ | إعداد البثّ ودعم المسار | أعد المحاولة مع تعطيل البثّ لعزل سبب الفشل. |
قد تعمل واجهة برمجة التطبيقات في Python أو cURL لكنها تفشل في المتصفح بسبب قيود المصدر المتبادل (CORS). لا تكشف مفتاح API غير مقيّد عبر وكيل عام غير آمن لمجرد تجاوز CORS.
الأسئلة الشائعة
هل يمكنني الاحتفاظ باتصال TypingMind الحالي أثناء إضافة CometAPI؟
نعم: أنشئ إدخال نموذج مخصص منفصل باسم عرض مميز بدلًا من تعديل إدخال المزود الحالي. احتفظ بإعدادات نقطة النهاية والنموذج الأصلية متاحة بينما تتحقق من اتصال CometAPI. اختبر أولًا في محادثة جديدة حتى لا يحجب طول محادثة قديمة أو مرفقاتها خطأ إعداد أساسي.
كيف أدير تدوير (استبدال) مفتاح CometAPI المستخدم في TypingMind؟
أنشئ مفتاحًا بديلًا، وحدّث كل إدخال نموذج مخصص يستخدم المفتاح القديم، واختبر طلبًا جديدًا من كل إدخال. ألغِ المفتاح القديم بعد نجاح البديل. إذا تم كشف المفتاح القديم، فألغِه فورًا واستعد الاتصالات المتأثرة بمفتاح جديد.
لماذا قد يختلف تقدير تكلفة TypingMind عن فاتورة CometAPI؟
يقدّر TypingMind الاستخدام بناءً على الأسعار التي تدخلها في إعدادات Pricing. قد تؤدي الأسعار القديمة أو الاختلافات في التخزين المؤقت أو مستويات السياق أو احتساب رموز الاستدلال إلى عدم تطابق. قارن الأسعار الحالية للنموذج واستخدام طلب محدد مع معلومات فوترة CometAPI؛ لا تتعامل مع تقدير جهة العميل كرسوم نهائية.
الخلاصة
لتوصيل CometAPI بـ TypingMind، أنشئ نموذجًا مخصصًا يدويًا، وأدخل نقطة نهاية Chat Completions الكاملة، وأضف ترويسة Authorization، واختبر برسالة نصية بسيطة. احتفظ بإعداد واحد يعمل قبل إضافة الميزات الاختيارية. عند فشل الإعداد، يساعد طلب cURL بسيط في التمييز بين أخطاء الحساب أو الـ API وبين مشكلات المتصفح وإعدادات الواجهة الأمامية.