ForHosting KIT · النصوص والذكاء الاصطناعي

استخراج أول كلمة

من «Hello, world — this is a preview.» تحصل على Hello بطول 5 أحرف، وعلى بقية السطر منفصلة. والعنوان المقتبس «Autumn notes» يعطي Autumn، و...first-word! يعطي first-word. مجانية في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

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

مثال محلول

إذا أدخلت

النص: Hello, world — this is a preview.

تحصل على

الكلمة الأولى: Hello
الطول: 5
الأصلي: Hello, world — this is a preview.
فهرس البداية: 0

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

كيف يعمل استخراج أول كلمة وما الذي يُعدّ كلمة

قصد البحث عن أول كلمة من نص أضيق من مجزّئ كامل أو قائمة كلمات فريدة: يريد الناس رمز الافتتاح لعنوان أو إشعار أو سطر سجل أو أمر، منظّفًا من الزينة التي تجلس حوله عادة. تعرّف هذه القدرة الكلمة بأنها أطول سلسلة من حروف Unicode والعلامات الجامعة والأرقام، تُوصل اختياريًا بفاصلة عليا أو واصلة داخليتين حتى تبقى الاختصارات مثل don't والمركبات مثل well-known رمزًا واحدًا. المسافات وعلامات الجدولة وأسطُر جديدة وعلامات الاقتباس والفواصل ونقاط الحذف والأقواس وسائر الترقيم ليست جزءًا من ذلك الرمز أبدًا.

قد تظهر قبل الكلمة أو بعدها أو في الجانبين؛ تُزال بدل أن تُعاد. لذلك تعطي عبارة Hello, world كلمة Hello، ويعطي عنوان مقتبس مثل "Autumn notes" كلمة Autumn، ويعطي سطر يبدأ بنقاط حذف مثل ...first-word! more text كلمة first-word.

الطول هو طول أحرف الشكل السطحي الذي وُجد، فـ café أربعة أحرف؛ أما كون النبرة مركّبة مسبقًا أم لا فمسألة بحث أخرى: يعيد المحرك الشريحة التي كانت فعلًا في الإدخال. بعد أول تطابق يُعرض باقي السلسلة في remainder بعد إزالة المسافات، فيصبح تحليل ثانٍ أو معاينة الجملة المتبقية على بعد حقل واحد.

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

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

تلصق واجهات المنتج عنوانًا أو رسالة وتعرض أول كلمة منظفة شارةً مدمجة بدل رمز محشو أو مرقّم.

بذور الشرائح وأسماء الملفات

يأخذ المحررون كلمة الافتتاح من عنوان بذرة شريحة أو جذر ملف ثم يطبقون قواعدهم الخاصة للأحرف الصغيرة أو الواصلات.

محللات الأوامر والسجلات

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

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

هل يبقى الترقيم المحيط على أول كلمة؟

لا. يُزال الترقيم والمسافات في البداية والنهاية. تصير Hello, هي Hello ويصير Autumn المقتبس Autumn. تبقى الواصلات والفواصل العليا الداخلية.

ما الذي يُعدّ كلمة؟

سلسلة من حروف Unicode أو علامات جامعة أو أرقام، تُوصل اختياريًا بفاصلة عليا أو واصلة داخليتين. لذلك يبقيان don't وwell-known رمزًا واحدًا.

ماذا تعرض النتيجة إلى جانب الكلمة؟

تعرض طول الكلمة بالأحرف والبقية، أي النص الذي يلي الكلمة بعد إزالة المسافات من طرفيه. في مثال Hello, world تكون البقية «, world — this is a preview.» جاهزة لمعالجة ثانية أو معاينة.

ماذا يحدث إذا لم يحتوِ النص على أي كلمة؟

يُرفض مع رسالة واضحة. فالنص الفارغ أو المكوّن من مسافات فقط أو من علامات ترقيم فقط لا ينتج كلمة، لأن الكلمة تحتاج إلى حرف أو رقم واحد على الأقل.

كيف تُستخدم مع أسطر السجلات أو الأوامر؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/str/first-word

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

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

curl -X POST https://api.kit.forhosting.com/str/first-word \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, world — this is a preview."}'

const res = await fetch("https://api.kit.forhosting.com/str/first-word", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Hello, world — this is a preview."
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/first-word",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "Hello, world — this is a preview."
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/first-word", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"Hello, world — this is a preview."}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"Hello, world — this is a preview."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/first-word", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "text": "Hello, world — this is a preview."
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_chars 100000

الأخطاء

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

ملاحظات تقنية

الدالة الحتمية نفسها تشغّل أداة المتصفح المجانية وواجهة API المدفوعة مسبقًا، فمعاينة نظام إدارة محتوى ومساعد شرائح واختبار وحدة تثبّت نفس JSON لنفس الإدخال. السلاسل بلا كلمات — الفارغة أو المسافات فقط أو الترقيم فقط — تفشل ب invalid_input ولا تُحاسب. استدعاءات API الناجحة تكلف $0.002 لكل عنصر.

عقد الإدخال وحقول الاستجابة والنص الفارغ أو الخالي من الكلمات

تفشل أيضًا السلسلة الفارغة أو المسافات فقط أو الترقيم فقط، لأنه لم يُعثر على كلمة تحمل حروفًا أو أرقامًا—تشير الرسالة إلى أن text يجب أن يحتوي كلمة واحدة على الأقل وأن المسافات والترقيم وحدهما لا يكفيان. يُحذف remainder عندما يكون الإدخال كلمة واحدة، ولا يُرسل أبدًا قيمة null. مثال: Hello, world — this is a preview. أرسلوا بهيئة POST جسم JSON مع حقل السلسلة الإلزامي text مضبوطًا على المقطع الذي ترغبون في مسحه. تُقبل الأسماء البديلة input وvalue وs وcontent وbody حتى يتمكن مولّدو النماذج والعملاء الأقدم من الإرسال بأسماء مألوفة. يجب أن تكون القيمة سلسلة؛ تفشل الكائنات والمصفوفات والقيم المنطقية والأعداد ب invalid_input مع تسمية المشكلة. تفشل الأحمال الأطول من سقف الأحرف الموثّق بالطريقة نفسها حتى لا يحتكر طلب واحد ذاكرة Worker. لا تُحاسب إخفاقات التحقق هذه على API المدفوع مسبقًا. عند النجاح تبلغ الاستجابة first_word بوصفه رمز الافتتاح المنظف، وlength بعدّ أحرفه، وoriginal صدى للإدخال لجداول الواجهة، وstart_index وend_index بإزاحات ذلك الرمز داخل original، وremainder بالسلسلة المتبقية بعد الكلمة بعد إزالة المسافات الخارجية، وmethod دائمًا first_word حتى يتفرع العملاء دون شمّ الأشكال. يعطي first_word هي Hello وlength خمسة وstart_index صفرًا وremainder يبدأ بفاصلة وبقية الجملة. سطر محشو بمسافتين وثلاث نقاط وwell-known وعبارة يعطي first_word هي well-known لأن الواصلة داخلية والترقيم الأمامي ليس كذلك.

المعاينات والشرائح وأنابيب التحليل والتسعير والحدود العملية

استدعوا أداة المتصفح المجانية للحصول على أول كلمة عندما تحتاجون رمز افتتاح نظيفًا لمعاينة بطاقة أو جذر اسم ملف أو شارة محادثة أو محلل أوامر ينبغي أن يتجاهل علامات الاقتباس المغلفة. تستخدم الأنابيب التحريرية الاستدعاء نفسه لتحويل عنوان إلى تسمية قصيرة دون سحب الفاصلة أو الشرطة إلى الشارة. لا تتوقعوا تجذيرًا ولا حذف كلمات فارغة ولا كشف لغة—تلك بحوث وعقود مختلفة. ثبّتوا عينات لـ Hello بسيطة ومركب بواصلة بعد ترقيم أمامي ورفض الترقيم الخالص حتى لا يغيّر إعادة الهيكلة العقد في صمت. يوصل المطوّرون واجهة KIT API المدفوعة مسبقًا عندما يحتاج نظام إدارة محتوى أو عميل جوّال أو مهمة دفعية العقد نفسه تحت رصيد ب $0.002 لكل عنصر ناجح؛ لا تستهلك إخفاقات التحقق الرصيد بعد رفض المحرك للطلب. سير عمل نمطي يلصق عنوانًا ويقرأ first_word ويحوّله إلى أحرف صغيرة محليًا إن احتاج مساعد شرائح بذرة. سير آخر يبني تثبيتات حتمية: غذّوا جملة مقتبسة معروفة، ثبّتوا first_word وstart_index، واجعلوا التكامل المستمر يفشل إن بدأ إعادة هيكلة لاحقة معاملة علامة الاقتباس الافتتاحية جزءًا من الرمز. اقرنوا نقطة النهاية بأداة تحويل شرائح أو أطول كلمة عندما تكون الخطوة التالية عنوان URL أو فحص تيبوغرافيا، لكن أبقوا get-first-word صفحة هبوط مستقلة حتى لا تختلط نية رمز الافتتاح بتحويل شرائح السلسلة كاملة أو عدّ الكلمات أو استخراج الكلمات المفتاحية.

أسئلة تقنية

كيف أحصل على أول كلمة من سلسلة نص؟

أرسلوا JSON مع text مضبوطًا على مقطعكم. تتضمن الاستجابة first_word وطوله وإزاحتي البداية والنهاية وremainder بما يلي تلك الكلمة.

ماذا يحدث إن خلا النص من الكلمات؟

يفشل الطلب ب invalid_input. تُرفض السلاسل الفارغة والإدخال المقصور على الترقيم ولا تُحاسب على API المدفوع مسبقًا.

كم يكلف مستخرج أول كلمة؟

أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا ب $0.002 لكل استدعاء ناجح؛ ولا يُحاسب الإدخال غير الصالح.

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

شغّل الأداة مجانًا