البدء
Widgets (التضمين في موقعك)
ضع ودجت محادثة أو صور أو كلام أو موسيقى أو فيديو بعلامتك الخاصة في موقعك بوسم script واحد، مقيَّدًا بنطاقاتك وحدود إنفاقك.
تضع الودجات (Widgets) واجهة ذكاء اصطناعي بعلامتك الخاصة في موقعك بوسم script واحد: محادثة أو صور أو كلام أو موسيقى أو فيديو، بأي نموذج في الكتالوج. لا يحتاج الزوار إلى مفتاح API. تُحاسَب الطلبات على رصيدك بالدولار بالسعر المعتاد للنموذج.
إنشاء ودجت
- افتح Widgets واختر New widget (أو صمّم واحدًا أولًا دون حساب في صفحة الودجات).
- اختر النوع والنموذج، ثم اضبط العنوان والألوان والسمة وانحناء الزوايا والنصوص والموضع. تقبل ودجات المحادثة أيضًا تعليمات خاصة وحدًّا لطول الرد.
- تشغّل المعاينة إعداداتك غير المحفوظة فعليًا، فيمكنك تجربة نموذج أو تعليمات قبل الحفظ. تُحاسَب طلبات المعاينة على رصيدك.
- احفظ، ثم انسخ كود التضمين.
كود التضمين
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
ضع الوسم داخل <body> حيث يجب أن يظهر الودجت. الخيارات:
| السمة | الأثر |
|---|---|
data-widget | مطلوبة. معرّف الودجت من لوحة التحكم. |
data-target | محدد CSS لعنصر يُعرَض الودجت داخله، مثل #support. بدونها يُعرَض الودجت قبل وسم script مباشرة. |
data-height | ارتفاع الودجت المضمَّن، مثل 520px. الافتراضي 480px للمحادثة و420px للأنواع الأخرى. |
يُعرَض الودجت داخل Shadow DOM معزول، فلا تتسرب أنماط صفحتك إليه ولا يغيّر هو صفحتك. مع موضع Floating button يُفتح من زر في الزاوية السفلية بدلًا من ذلك.
المواقع المسموح بها
لا يجيب الودجت إلا على الطلبات القادمة من المواقع التي تدرجها في الإعدادات، مواقع الودجت. نطاق واحد في كل سطر، والنطاق يغطي نطاقاته الفرعية أيضًا (example.com يغطي www.example.com). أضف منفذًا للسماح بذلك المنفذ فقط، مثل localhost:3000 للاختبار المحلي. تعمل المعاينة في لوحة التحكم دائمًا.
الصفحة في أي موقع آخر تتلقى 403 site_not_allowed ولا يُعرَض الودجت (تعرض وحدة تحكم المتصفح سطرًا واحدًا يشرح السبب).
يعتمد الفحص على ترويسة Origin في المتصفح. لا تستطيع المتصفحات تغييرها، لكن الأدوات خارج المتصفح تستطيع، لذا اعدّ قائمة المواقع قيدًا لا سرًّا. ما يحدّ التكلفة فعلًا هي ضوابط الإنفاق أدناه.
ضوابط الإنفاق
لأن الودجت عام، فتكلفته محدودة بضوابط لا يغيّرها سواك:
| الضابط | أين | الأثر |
|---|---|---|
| حد الإنفاق اليومي لهذا الودجت | محرر الودجت | عندما ينفق الودجت هذا المبلغ اليوم (UTC) يتوقف حتى اليوم التالي: 429 widget_daily_limit. |
| حد الإنفاق اليومي لكل الودجات | الإعدادات، ضوابط الودجت | سقف واحد عبر كل ودجات الحساب. |
| الطلبات لكل زائر في اليوم | الإعدادات، ضوابط الودجت | تُحتسب لكل عنوان IP للزائر ولكل ودجت. الافتراضي 100: 429 visitor_daily_limit. |
| الطلبات لكل زائر في الدقيقة | ثابت | 10 في الدقيقة لكل زائر: 429 rate_limited. |
| معدل الودجت | خطتك | يتشارك كل زوار ودجت واحد عدد الطلبات في الدقيقة المسموح به في خطتك. |
رصيدك هو الحد الأخير: عند 0 دولار يُعيد كل ودجت 402 insufficient_balance إلى أن تضيف رصيدًا.
الحالة والتنبيهات
تعرض قائمة الودجات وقت آخر استخدام لكل ودجت، وإنفاق اليوم وطلباته، وآخر خطأ عندما يفشل الودجت لسبب يمكنك إصلاحه: رصيد فارغ، أو نموذج محذوف، أو حد إنفاق وُصل إليه، أو موقع غير مدرج في القائمة. مع تفعيل Email me when a widget fails (الإعدادات، ضوابط الودجت) تتلقى بريدًا واحدًا على الأكثر لكل ودجت في اليوم.
تعرض صفحة Usage طلبات الودجت باسم الودجت والموقع الذي جاءت منه؛ جمّع بحسب By widget أو By site للمقارنة بينها.
ما يراه الزوار
- تصل إجابات المحادثة بالبث وتدعم التنسيق الأساسي (فقرات وقوائم وخط عريض ومائل وكود وروابط). تبقى المحادثة بينما ينتقل الزائر بين الصفحات في التبويب نفسه.
- يوقف زر Stop إجابة طويلة؛ وبعد خطأ يعيد رابط Try again إرسال الرسالة.
- تأتي الصور والصوت والفيديو مع رابط Download. يُولَّد الفيديو كمهمة في الخلفية ويظهر عند جاهزيته، عادةً خلال بضع دقائق.
- لا يرى الزوار تعليماتك ولا رصيدك ولا خطأ النموذج الخام. يرون رسالة الخطأ التي كتبتها (أو رسالة افتراضية محايدة)، ويظهر لك السبب في لوحة التحكم.
- النصوص التي تتركها فارغة تستخدم القيم الافتراضية بلغة حسابك.