ForHosting KIT · أدوات المطورين

اختصار النص حسب عدد الكلمات مع علامة حذف

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

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

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

اختر حدا مناسبا لعدد الكلمات

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

افهم المسافات وحدود الكلمات

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

استخدم النتيجة في إجراءات قابلة للتكرار

في الأعمال المتكررة، استخدم الحد نفسه لعدد الكلمات والنهاية نفسها لكل العناصر المخصصة للموضع ذاته. يمنح ذلك شبكات المنتجات والنشرات البريدية وقواعد المعرفة وصفحات البحث إيقاعا بصريا أكثر اتساقا، كما يقدم للمساهمين قاعدة واضحة. يتيح مؤشر الاختصار للشفرة اللاحقة التمييز بين مقتطف أنشأته الأداة ونص أصلي كان ضمن الحد من البداية. ويفيد عددا الكلمات الأصلي والنهائي في عمليات التدقيق والاختبارات ومسارات المحتوى التي تحتاج إلى إثبات التحويل. العملية حتمية؛ فالنص والحد واللاحقة المتطابقة تعطي نتيجة متطابقة، من دون تفاوت نماذج أو اعتماد على الشبكة. لذلك تناسب الأداة نصوص البناء والمعالجة الدفعية التي تتطلب معاينات مستقرة. يبلغ السعر الأساسي لكل طلب $0.002 عند استخدام القدرة المستضافة؛ ويطبق إصدار المتصفح الخوارزمية الأساسية نفسها. تعامل مع المقتطف بوصفه نصا للعرض لا ملخصا تلقائيا، لأن الاختصار يحتفظ ببداية المصدر ولا يحدد الحقائق المهمة التي قد تظهر في أجزائه اللاحقة.

حالات الاستخدام

بطاقات المقالات والمدونات

أنشئ نصوصا تمهيدية موحدة لصفحات القوائم، مع ضمان انتهاء كل بطاقة بعد كلمة مكتملة.

معاينات المنتجات والكتالوجات

قصّر الأوصاف الطويلة وفق حد مشترك للكلمات كي تصبح الشبكات والموجزات وشاشات المقارنة أوضح.

مقتطفات البريد الإلكتروني والإشعارات

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

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

هل تدخل علامة الحذف ضمن الحد الأقصى للكلمات؟

لا. يحدد الحد عدد كلمات المصدر التي تبقى، ثم تضاف علامة الحذف بعد ذلك فقط عندما تزال كلمات من النص.

ماذا يحدث إذا كان النص قصيرا بما يكفي؟

يعاد النص من دون علامة حذف، ويبين حقل الاختصار أن الأداة لم تزل أي محتوى.

كيف تحسب الأداة الكلمات؟

الكلمة سلسلة من الأحرف غير البيضاء. تفصل المسافات وعلامات الجدولة وفواصل الأسطر بين الكلمات، وتعامل المسافات المتكررة بوصفها فاصلا واحدا.

هل يمكنني تغيير علامة الحذف أو إزالتها؟

نعم. يمكنك تقديم نهاية مخصصة لا تتجاوز 32 حرفا، أو استخدام سلسلة فارغة لإزالة اللاحقة الظاهرة.

هل تلخص الأداة النص الأصلي أو تعيد كتابته؟

لا. تحتفظ بالكلمات الأولى حسب ترتيبها الأصلي حتى الحد المطلوب، وتحذف البقية من دون تفسير المحتوى.

للمطوّرين — الوصول عبر API

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

الـEndpoint

POSThttps://api.kit.forhosting.com/str/truncate-words

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/str/truncate-words \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"The quick brown fox jumps over the lazy dog","words":5}'

const res = await fetch("https://api.kit.forhosting.com/str/truncate-words", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "The quick brown fox jumps over the lazy dog",
    "words": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/truncate-words",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "The quick brown fox jumps over the lazy dog",
    "words": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/truncate-words", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"The quick brown fox jumps over the lazy dog","words":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"The quick brown fox jumps over the lazy dog","words":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/truncate-words", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "text": "The quick brown fox jumps over the lazy dog",
  "words": 5
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.truncate_words",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_chars`	100000
`max_words`	10000
`max_ellipsis_chars`	32

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←