تحقق من سهولة القراءة للجمهور المستهدف
لا تصبح درجة سهولة القراءة مفيدة إلا عند تفسيرها وفق الأشخاص الذين سيقرؤون المادة.
شغّل الأداة مجانًا
تستقبل هذه الأداة مستوى دراسيا محسوبا وجمهورا مستهدفا، ثم تقارن الرقم بنطاق متوقع واضح. وتبين لكم ما إذا كان النص ملائما أو أسهل من اللازم أو أصعب من اللازم. استخدموها بعد أي حاسبة لمستوى القراءة لتحويل الدرجة المجردة إلى قرار تحريري متسق للمعلومات العامة أو الوثائق التقنية أو المواد المكتوبة للأطفال.
ابدؤوا بمستوى دراسي محسوب
تقيّم هذه الإمكانية مستوى متوفرا لديكم مسبقا؛ فهي لا تحلل نصا خاما ولا تحسب معادلة لسهولة القراءة. أدخلوا النتيجة الرقمية من أداة مثل Flesch-Kincaid مع أحد معرفات الجمهور المدعومة. تقبل القيم العشرية لأن معادلات القراءة كثيرا ما تنتج قيما مثل 7.4. تحتفظ الأداة بالقيمة وتقارنها بحدين مشمولين في النطاق. يتوقع للأطفال المستوى من 1 إلى 5، وللجمهور العام من 6 إلى 8، وللمواد التقنية من 9 إلى 14. هذه النطاقات أهداف تحريرية وليست أحكاما على تعليم شخص أو قدرته. إذا وقعت الدرجة داخل النطاق كانت ملائمة، وإذا انخفضت عنه كان النص أسهل من اللازم، وإذا تجاوزته كان أصعب من اللازم. يتيح فصل الحساب عن تقييم الجمهور إعادة استخدام القرار مع أنظمة قياس مختلفة، ما دامت مخرجاتها تمثل مستوى دراسيا معتادا. كما يسمح بحفظ الدرجة الأصلية بجوار قرار السياسة للرجوع إليهما في مراجعة لاحقة.
اختاروا الجمهور وفقا لوظيفة الوثيقة
اختاروا children حين تكون المادة مكتوبة عمدا لقراء صغار مستقلين، مثل التعليمات المدرسية أو أنشطة المتاحف أو شروح السلامة الأساسية. واختاروا general_public للخدمات والإعلانات وصفحات المساعدة ومعلومات المستهلك التي ينبغي فهمها بلا تدريب متخصص. واستخدموا technical عندما يفترض إلمام القارئ بمفردات مهنية وقدرته على متابعة تراكيب أكثر كثافة، كما في الملاحظات الهندسية أو مفاهيم API أو إجراءات البحث. أسماء الجمهور دقيقة، وهي children وgeneral_public وtechnical. تؤدي أي قيمة غير معروفة إلى خطأ في الإدخال بدلا من التخمين، لأن الخيار الافتراضي الصامت قد يجيز محتوى وفق المعيار الخطأ. يجب أن يتبع الاختيار غرض الوثيقة لا هوية كاتبها فقط. فقد تنشر شركة برمجيات إرشادات فوترة للجمهور العام ووثائق دمج تقنية. كذلك، ليست الدرجة المنخفضة أفضل دائما؛ فقد يحذف التبسيط المفرط دقة لازمة، بينما قد يمنع النص الأعلى من نطاق الأطفال قراءه المقصودين من التصرف بثقة.
استخدموا التقييم إشارة تحريرية
تتضمن النتيجة المستوى المدخل والجمهور المختار والنطاق المتوقع بدقة وقيمة منطقية للمطابقة وتقييما موجزا. تعني المطابقة أن الرقم داخل النطاق، مع شمول الحدين. أما النتيجة الأصعب من اللازم فتدعو إلى مراجعة الجمل الطويلة والتراكيب المتداخلة والكلمات غير المألوفة والمصطلحات غير المشروحة، ثم قياس النسخة المنقحة. وتعني النتيجة الأسهل من اللازم أن النص أدنى من الهدف؛ وفي العمل التقني ينبغي التأكد من أن التبسيط لم يحذف فروقا أو قيودا أو مصطلحات يحتاج إليها القارئ. النتيجة حتمية، فالمدخلات المتطابقة تنتج دائما مخرجات متطابقة من دون حكم نموذج أو اتصال بالشبكة أو عشوائية أو بيانات مرجعية متغيرة. لذلك تصلح الأداة لبوابات النشر وأنظمة إدارة المحتوى وعمليات التدقيق القابلة للتكرار. ومع ذلك، يقيس المستوى الصعوبة السطحية لا صحة الحقائق أو النبرة أو سهولة الوصول أو الملاءمة الثقافية. اعتبروا المطابقة دليلا واحدا لا موافقة نهائية. وتظل المراجعة البشرية مهمة للتعليمات المؤثرة ومواد الأطفال. وعند الأتمتة، احتفظوا بالدرجة والتقييم كي يفهم المراجعون سبب التنبيه أو الإجازة وأي استثناء موثق.
حالات الاستخدام
اضبطوا محتوى الخدمات العامة
ضعوا علامة على الإعلانات التي تتجاوز نطاق الجمهور العام قبل النشر كي يتمكن المحرر من تبسيطها.
راجعوا المواد التعليمية للأطفال
قارنوا المستوى المحسوب بنطاق الأطفال وحددوا المقاطع التي تحتاج إلى مراجعة.
وحّدوا الوثائق التقنية
طبّقوا سياسة صريحة لمستوى القراءة على الأدلة وقواعد المعرفة ووثائق الإصدارات.
الأسئلة الشائعة
هل تحسب هذه الأداة المستوى من النص؟
لا. أدخلوا مستوى محسوبا مسبقا بمعادلة لسهولة القراءة أو بأداة قياس أخرى.
ما النطاقات المستخدمة؟
يستخدم الأطفال المستويات 1–5، والجمهور العام 6–8، والقراء التقنيون 9–14. والحدود مشمولة.
هل يمكن أن يتضمن المستوى كسورا عشرية؟
نعم. تقبل أي قيمة رقمية منتهية بين 0 و20، وتحتفظ بها في النتيجة.
ماذا يحدث عند إدخال جمهور غير معروف؟
يفشل الطلب بخطأ إدخال غير صالح بدلا من اختيار نطاق تلقائيا.
ما تكلفة الفحص عبر API؟
تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن إجراء الفحص الحتمي نفسه مجانا في المتصفح.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/write/readability-by-audience \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"grade_level":7.4,"audience":"general_public"}'const res = await fetch("https://api.kit.forhosting.com/write/readability-by-audience", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"grade_level": 7.4,
"audience": "general_public"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/write/readability-by-audience",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"grade_level": 7.4,
"audience": "general_public"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/write/readability-by-audience", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"grade_level":7.4,"audience":"general_public"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"grade_level":7.4,"audience":"general_public"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/write/readability-by-audience", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"grade_level": 7.4,
"audience": "general_public"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "write.readability_by_audience",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_tokens | 20000 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |