> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# ربط BuildShip بـ CometAPI
> استخدم هذا الدليل لربط BuildShip بـ CometAPI عبر تعيين base URL وAPI key وخيارات model أو provider.
BuildShip هو أداة إنشاء خلفية مرئية منخفضة البرمجة. استخدم عقدة المجتمع **CometAPI Text Generator** لإضافة توليد نصوص مدعوم بالذكاء الاصطناعي إلى أي سير عمل.
## المتطلبات المسبقة
* حساب CometAPI مع مفتاح API نشط — [احصل على مفتاحك من هنا](https://www.cometapi.com/console/token)
* حساب BuildShip — [سجّل الدخول من هنا](https://app.buildship.com)
سجّل الدخول إلى [لوحة تحكم CometAPI](https://www.cometapi.com/console/token). انقر على **Add API Key** وانسخ مفتاح API الخاص بـ CometAPI.
1. في لوحة تحكم BuildShip، انقر على **Create a new workflow → From Scratch**.
2. على لوحة العمل، انقر على **Add Trigger** واختر **REST API**. سيؤدي ذلك إلى إنشاء endpoint قابل للاستدعاء لهذا الـ workflow.
1. أسفل REST API trigger، انقر على **+ Add a new step**.
2. في مربع البحث داخل مكتبة العقد، اكتب `cometapi`.
3. من قائمة **Community**، اختر **CometAPI Text Generator**.
تحدد هذه الخطوة نظام إدارة المفاتيح الذي ستستخدمه العقدة.
1. انقر على العقدة لفتح **Node Editor** على اليمين.
2. انتقل إلى تبويب **Settings**.
3. في **Key-based Integration**، افتح القائمة المنسدلة واختر **CometAPI**.
4. انقر على زر **Save** الأزرق في الزاوية العلوية اليمنى.
1. في Node Editor، انتقل إلى تبويب **Inputs** (أو انقر مباشرة على العقدة).
2. انقر على أيقونة المفتاح 🔑 في الزاوية العلوية اليمنى من العقدة لفتح القائمة المنسدلة الخاصة بالمفاتيح.
3. اختر **+ Bring your own Key**.
4. أدخل **Key ID** (مثل `cometapi-key-1`) والصق مفتاح API الخاص بـ CometAPI في **Value**.
5. انقر على **Save**.
في تبويب **Inputs** الخاص بالعقدة:
* **Instructions** (اختياري): عيّن system role، مثل `You are a productivity assistant.`
* **Prompt**: انقر على أيقونة **``**، ثم اختر **Trigger → Body → prompt** لربط body الخاص بالطلب الوارد.
* **Advanced → Model**: أدخل model ID الحالي الذي تريد استخدامه.
1. أسفل عقدة CometAPI، انقر على **+ Add a new step** واختر **Return Response**.
2. في حقل **Body**، انقر على **``** واختر المتغير `response` من عقدة CometAPI Text Generator.
3. انقر على **Test** في الزاوية العلوية اليمنى، واختر تنسيق الإدخال **JSON**، ثم أرسل:
```json theme={null}
{
"prompt": "hi"
}
```
4. يؤكد ظهور استجابة ناجحة في لوحة **Result** أن الـ workflow يعمل.
إذا فشل الاستدعاء، فتحقق من مفتاح API الخاص بك ومن أن **Key-based Integration** مضبوط على **CometAPI**، أو تواصل مع [دعم CometAPI](https://www.cometapi.com).
خطوة **Key-based Integration** (ربط العقدة بـ CometAPI) أساسية — تخطيها سيسبب أخطاء في المصادقة حتى إذا كان مفتاح API الخاص بك صحيحًا.