إدخال JSON بسيط
أرسل المسودة واسم نموذج مدعوم. تعيد الاستجابة نصًا عاديًا إلى جانب النموذج وعدد الكلمات المعالجة.
REST API / إعادة كتابة النص
واجهة API لإضفاء الطابع البشري على النص لإعادة الكتابة الطبيعية والقابلة للتحرير
أرسل مسودة، واختر نموذج إعادة كتابة، واحصل على نسخة جديدة داخل سير عملك. تظل الاستجابة سهلة التحرير والمقارنة والاعتماد قبل نشرها في أي مكان عام.
استخدم المفتاح من بيئة خادم خاص.
طلب cURL
curl --request POST \
--url https://api.detecting-ai.com/api/humanize/ \
--header "Content-Type: application/json" \
--header "Idempotency-Key: humanizer-review-001" \
--header "X-API-Key: YOUR_API_KEY" \
--data '{
"text": "Paste the text you want to rewrite.",
"model": "cognia"
}'01
طلبات POST إلى /api/humanize/
02
المصادقة عبر X-API-Key
03
مفتاح Idempotency-Key يحدده العميل لإعادة المحاولات بأمان
04
أربعة نماذج مدعومة
05
استخدام الكلمات في كل رد
خطوة إعادة الكتابة التي تتحكم فيها
احتفظ بالنص الأصلي وإعادة الصياغة والتحرير النهائي في مسار واحد
لا يخفي التكامل الجيد ما تغير. احتفظ بالنسخة الأصلية، واطلب إعادة كتابتها، وامنح المحرر مكانًا واضحًا لمقارنة النسختين قبل اعتماد النتيجة.
يبقى اختيار النموذج واضحًا
حدد cognia، lexi، cognia_v2، أو huma_v2 بناءً على السلوك الذي اختبره فريقك للمحتوى الخاص به.
قابل للتحرير حسب التصميم
أعد النص الناتج إلى محرر أو قائمة انتظار للمراجعة أو نظام محتوى، بدلًا من معاملته كناتج نهائي.
بنية الطلب
أرسل المسودة وحدد النموذج
كلا الحقلين مطلوب في نقطة نهاية REST. احتفظ باختيار النموذج ضمن الإعدادات كي تستطيع اختباره وتغييره من دون إعادة كتابة التكامل.
| حقل | النوع | مطلوب | ماذا يفعل |
|---|---|---|---|
| text | string | نعم | النص المقدم الذي تريد الخدمة إعادة كتابته. |
| model | string | نعم | واحد من cognia، lexi، cognia_v2، أو huma_v2. |
ثلاثة حقول تجعل من السهل تتبع النتيجة
استخدم humanized_text بوصفه نتيجة قابلة للتحرير. وسجّل model_used وwords_processed بجانبه كي تفهم فرق الدعم والفوترة والمحتوى كيفية معالجة الطلب.
مثال للرد
{
"humanized_text": "The rewritten text is returned here.",
"words_processed": 8,
"model_used": "cognia"
}مسار التكامل
تعامل مع إعادة الصياغة كمسودة تحتاج إلى اعتماد تحريري
يبقي أفضل مسار عمل النسخة الأصلية ظاهرة، ويطلب من شخص اعتماد النسخة الجديدة.
- 1
احمِ مفتاح API
خزّن المفتاح على خادمك أو في مدير أسرار. لا تضعه في شفرة المتصفح العامة أو في مستند مشترك.
- 2
أرسل نصًا بنموذج تم اختباره
اختر نموذجًا مدعومًا، واحفظ Idempotency-Key فريدًا قبل الإرسال، ولا تعد استخدامه إلا للمحاولة نفسها بالضبط.
- 3
راجع النتيجة واعتمدها
تحقق من النص المعاد كتابته للتأكد من دقته ومعناه وأسلوبه ومصطلحاته المطلوبة قبل حفظه أو نشره.
حالات مناسبة
مناسب عمليًا للمنتجات التي تحتوي بالفعل على محرر
تكون إعادة الصياغة أكثر فائدة عندما تكون المسودة قيد المراجعة بالفعل. تضيف API خيارًا لإعادة الكتابة من دون إقصاء المسؤولين عن النص النهائي.
إعادة الكتابة يمكن أن تغير المعنى
الأسماء والاقتباسات والأرقام واللغة القانونية والمصطلحات الفنية تستحق التدقيق الدقيق. أبقِ هذه التفاصيل مرئية للمراجع.
إدارة المحتوى
اعرض إجراء إعادة الصياغة داخل نظام إدارة المحتوى، وأعد النتيجة إلى المسودة نفسها للمقارنة والاعتماد.
عمليات الدعم
حوّل المواد المرجعية المعتمدة إلى نص مساعدة أوضح، ثم أخضعه للمراجعة المعتادة للحقائق والسياسات.
قوائم الانتظار التحريرية
أضف خيار إعادة الصياغة بجانب النص الأصلي كي يتمكن المحرر من الاحتفاظ بكل تعديل أو دمجه أو رفضه.
أدوات الكتابة الخاصة
اتصل بالخدمة من واجهة خلفية موثوقة، ولا تعرض للمستخدم المسجل دخوله إلا النص الناتج الذي يحتاج إليه.
الأسئلة الشائعة عن API
إجابات عملية قبل الإطلاق
ابدأ بطلب من الخادم، وسجّل بنية الاستجابة، ثم أضف النتيجة إلى مسار المراجعة الحالي لديك.
ما نقطة النهاية التي تستخدمها واجهة API لإضفاء الطابع البشري على النص؟+
أرسل طلب POST إلى https://api.detecting-ai.com/api/humanize/. استخدم JSON ومرّر مفتاحك في X-API-Key، واحتفظ بقيمة Idempotency-Key ثابتة لكل عملية منطقية حتى يمكن استرداد نتيجة المحاولات المتكررة.
ما نماذج إعادة الكتابة المتاحة؟+
قيم النموذج المدعومة هي cognia وlexi وcognia_v2 وhuma_v2. تتطلب REST API حقل model في كل طلب.
ماذا يحتوي الرد؟+
تتضمن الاستجابة الناجحة humanized_text وwords_processed وmodel_used. ويظل النص المعاد صياغته قابلًا للتحرير في منتجك.
هل يجب نشر مخرجات API دون مراجعة؟+
لا. راجع المعنى والحقائق والنبرة والأسماء والروابط وأي عبارات يجب الحفاظ على دقتها. قد تحسن إعادة الصياغة سلاسة النص، لكن النتيجة تظل بحاجة إلى محرر.
كيف يُحسب استخدام أداة إضفاء الطابع البشري؟+
يعتمد الاستخدام على عدد كلمات الإدخال، ويُخصم من رصيد أداة إضفاء الطابع البشري المرتبط باشتراك API. وتعرض الاستجابات الناجحة الحقل words_processed.
أنشئ طلبك الأول
اختبر إعادة الكتابة على النص الذي تعرفه جيدًا
ابدأ بنموذج واحد، وقارن النتيجة بالنص الأصلي، وحدد ما يحتاج المحررون إلى التحقق منه قبل إطلاق الميزة.