AI Humanizer واجهة برمجة التطبيقات
حوّل نص AI داخل منتجك باستدعاء REST واحد. تتيح واجهة AI humanizer API المحرك الذي يشغّل TextPulse لواجهة الخلفية لديك: يدخل JSON، ويعود نثر معاد الصياغة، عبر أكثر من 60 لغة.
إجراء أول طلب لك
صادِق باستخدام ترويسة Authorization: Bearer وأرسل نصك. تعود النسخة المعاد صياغتها على هيئة outputText إلى جانب بيانات القياس الخاصة بذلك الاستدعاء.
curl https://textpulse.ai/api/v1/humanize \ -H "Authorization: Bearer tp_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Our analysis indicates the intervention produced gains...", "writingMode": "Academic", "intensityScalar": 0.5 }'{ "outputText": "Our analysis points to measurable gains from the...", "metrics": { "inputWords": 128, "outputWords": 134, "wordsCharged": 128, "balanceRemaining": 99872, "modelLatencyMs": 4310, "route": "v1/humanize" }}ما هي واجهة برمجة التطبيقات لـ AI humanizer؟
واجهة برمجة التطبيقات لـ AI humanizer هي نقطة نهاية REST تعيد صياغة النص المُولَّد آليًا إلى نثر طبيعي يبدو بشريًا من داخل منتج آخر. بدلًا من لصق النص في تطبيق ويب، يرسله نظامك الخلفي بصيغة JSON ويتلقى النسخة المعاد صياغتها في الاستجابة، وبذلك تصبح humanization ميزة في برنامجك نفسه: زرًا في محرر، أو مرحلة في خط معالجة المستندات، أو مهمة دفعية على مكتبة محتوى.
تُظهر واجهة برمجة التطبيقات لـ TextPulse humanizer المحرك نفسه الذي يعمل في لوحة تحكم TextPulse. وهي تعمل عبر أكثر من 20 إشارة لغوية في الوقت نفسه، مع تنويع طول الجملة وبنيتها واستبدال المفردات التي تميل نماذج اللغة إلى الإفراط في اختيارها، بينما تمر الاستشهادات داخل النص، ومدخلات المراجع، والإحصاءات، والمصطلحات الثابتة كما هي حرفيًا. في مجموعة أكاديمية تضم 2,000 مستند، اجتاز الناتج المُنسَّن Turnitin AI بنسبة 92.33% من الوقت، وOriginality.ai بنسبة 89.12%، وGPTZero بنسبة 87.91%. هذا السلوك بمستوى أكاديمي هو ما يميزه عن نقاط نهاية إعادة الصياغة العامة: النص الذي يستلمه المستخدمون ليس مجرد مختلف، بل صالح للنشر.
ما الذي تتولاه واجهة AI humanizer API نيابةً عنك
توجيه اللغة، والتحكم في السجل، والقياس، وأمان إعادة المحاولة كلها جزء من نقطة النهاية، لذا يظل تكاملك دالة واحدة.
مسار واحد يغطي أكثر من 60 لغة
تعمل الإنجليزية على محرك humanizer المضبوط بدقة. مرّر قيمة لغة، فيُوجَّه الطلب إلى المسار متعدد اللغات بدلًا من ذلك، بحيث يصل صفحة منتج غير إنجليزية إلى نقطة النهاية نفسها دون تكامل ثانٍ.
السجل والقوة معلمتان
تغطي خمسة أنماط كتابة السجلات Academic وCorporate وCreative وBlog/SEO وGeneral. تضبط قيمة intensityScalar مقدار اختلاف إعادة الصياغة عن النص الأصلي، وتأخذ إحدى القيم 0 أو 0.25 أو 0.5 أو 0.75 أو 1، من Mild مرورًا بالافتراضي Balanced عند 0.5 وصولًا إلى Aggressive.
طلب POST واحد لكل مستند
لا توجد قائمة مهام للمتابعة ولا webhook لتسجيله. يبقي استدعاء humanize الاتصال مفتوحًا حتى يعيد النموذج النتيجة ويرد بالنص المعاد صياغته، لذا ينجز طلب واحد العمل.
إعادة المحاولة لا تُحتسب مرتين
أرسل requestId وسيُخزَّن الناتج مقابله لمدة نحو عشر دقائق. تكرار المعرف نفسه داخل تلك النافذة يعيد الاستجابة المخزنة بدلًا من تشغيل النموذج مرة أخرى، وأي طلب يعجز المحرك عن إكماله تُعاد كلماته إلى رصيدك تلقائيًا.
مرجع نقطة النهاية
Authorization: Bearer. تبدأ المفاتيح بـ tp_live_ وتُصدر لكل مشروع./api/v1/humanize/api/v1/balanceيقبل استدعاء humanize واحد حتى 1,000 كلمة ضمن حد 10,000 حرف، ويمكن لكل مفتاح إصدار 60 طلبًا في الدقيقة. تُرسل المستندات الأطول كسلسلة من الاستدعاءات.
معلمات الطلب
المطلوب فقط هو text. كل شيء آخر له قيمة افتراضية مناسبة، لذا فإن التكامل الأدنى يتطلب حقلاً واحدًا.
| المعلمة | Type | الحضور | ملاحظات |
|---|---|---|---|
text | string | مطلوب | النص المراد تنسيقه ليبدو بشريًا. حتى 1,000 كلمة ضمن حد أقصى قدره 10,000 حرف لكل طلب. |
writingMode | string | الافتراضي: Academic | أحد الخيارات Academic أو Corporate أو Creative أو Blog/SEO أو General. يحدد السجل الذي تحتفظ به إعادة الصياغة. |
intensityScalar | number | الافتراضي: 0.5 | أحد الخيارات 0 أو 0.25 أو 0.5 أو 0.75 أو 1. مدى ابتعاد إعادة الصياغة عن النص الأصلي، من Mild عبر Balanced إلى Aggressive. |
language | string | اختياري | يوجه النص غير الإنجليزي إلى المسار متعدد اللغات. احذفه، أو أرسل الإنجليزية، للحصول على المحرك الإنجليزي المضبوط بدقة. |
englishVariant | string | اختياري | الأمريكية أو البريطانية. يحافظ على الإملاء والمفردات على أحد جانبي الأطلسي. |
freezeTerms | string[] | اختياري | حتى 10 مصطلحات أو عبارات تمر عبر إعادة الصياغة حرفيًا: أسماء الإنشاءات، والأدوات، وأسماء المنتجات. |
removeEmDashes | boolean | اختياري | يعيد صياغة تراكيب الشرطة الطويلة إلى علامات ترقيم تقليدية. |
requestId | string | موصى به | رمز idempotency الخاص بك. يؤدي تكراره خلال نحو عشر دقائق إلى إعادة الاستجابة المخزنة بدلًا من احتساب رسوم مرة أخرى. |
حقول الاستجابة
outputTextالنص المُنسَّن.metrics.inputWords / outputWordsعدد الكلمات المستلمة وعدد الكلمات المعادة. غالبًا ما تكون إعادة الصياغة أطول قليلًا من النص الأصلي.metrics.wordsChargedتكلفة الاستدعاء. تساوي دائمًا عدد الكلمات المدخلة، وليس عدد الكلمات الناتجة.metrics.balanceRemainingأرصدة الكلمات المتبقية على المفتاح بعد هذا الاستدعاء، حتى تتمكن من القياس دون طلب ثانٍ.metrics.modelLatencyMs / routeزمن المحرك لإعادة الصياغة والمسار الذي خدمها.الأخطاء وإعادة المحاولة
يعيد كل خطأ JSON مع error.code ثابت ورسالة قابلة للقراءة البشرية. القاعدة الجديرة بأن تُبنى عليها المنظومة: لا تُحاسَب إلا على إعادة صياغة تم تسليمها، وإعادة المحاولة باستخدام requestId نفسه آمنة دائمًا.
UNAUTHORIZEDمفتاح API مفقود أو غير معرّف. تحقّق من ترويسة Authorization: Bearer.INSUFFICIENT_BALANCEلا توجد أرصدة كلمات كافية على المفتاح. تتضمن الاستجابة الرصيد المتاح.REQUEST_IN_PROGRESSالطلب الذي يحمل requestId هذا لا يزال قيد المعالجة. انتظر بدلًا من التنافس معه.TOO_LONG / VALIDATION_FAILEDيتجاوز الإدخال حد 1,000 كلمة أو أن إحدى المعلمات غير صحيحة. تسرد الاستجابة المشكلات الدقيقة.ENGINE_ERRORفشل المحرك أو انتهت مهلة التنفيذ. الكلمات أُعيدت بالفعل إلى رصيدك؛ أعد المحاولة باستخدام requestId نفسه.المحرّك الذي يقف خلف نقطة النهاية
تعمل كل عملية استدعاء على تشغيل محرّك TextPulse المنشور، وقد جرى قياسه على corpus أكاديمي يضم 2,000 وثيقة، ثم إعادة تشغيله مع تحديث نماذج الكشف. معدلات النجاح بحسب الكاشف:
أرقام مقاسة من المورّد، منشورة مع corpus الخاص به. لا يمكن لأي humanizer أن يَعِد بنتيجة كاشف على وثيقة بعينها، لذا ينبغي أن تُبنى رسائل منتجك على القياس، لا على الضمان.
ما الذي تبنيه الفرق على واجهة برمجة تطبيقات humanizer
منصات EdTech والكتابة
أضف إجراء humanize إلى جانب ميزات التدقيق النحوي أو إعادة الصياغة الموجودة لديك. يحافظ وضع Academic على الاستشهادات كما هي، بحيث لا تضطر الأدوات الموجّهة إلى الطلاب إلى حذف المراجع قبل إرسال النص.
أدوات المستندات والتدقيق اللغوي
مرّر المستندات كاملة عبرها على دفعات من 1,000 كلمة ثم أعد تجميعها. تحافظ Freeze terms على ثبات الأسماء والمصطلحات عبر الدفعات، وتتيح المحاولات المعادة عديمة الأثر إعادة تشغيل خطوط المعالجة الدفعية بأمان.
منتجات المحتوى وSEO
يعيد وضع Blog/SEO صياغة المسودات إلى نثر صالح للنشر، بينما تثبّت Freeze terms الكلمات المفتاحية المستهدفة، بحيث يحافظ النص على قصده البحثي ويفقد الإيقاع الآلي.
شركاء العلامة البيضاء
تعمل نقطة النهاية بشكل غير مرئي داخل منتجك: واجهتك، وفوترةك، ومحرّكنا. تُسعَّر ترتيبات الشراكة وفق الحجم الشهري عبر نموذج الوصول.
تسعير AI humanizer API
الأرصدة مدفوعة مقدمًا وتُخصم حسب الكلمة. تحتسب الفوترة ما ترسله لا ما يعيده المحرك، وأي استدعاء يفشل في إنتاج إعادة صياغة يُعاد رصيده إلى المفتاح.
تكون الاعتمادات صالحة لمدة 12 شهرًا من تاريخ الشراء، وتغطي كل لغة ووضع كتابة ومتغير إنجليزي يدعمه الطرف النهائي. وللحجم المستمر أو لترتيب white-label داخل منتجك الخاص، اطلب الوصول وسنقدّم عرضًا وفق رقمك الشهري.
أسئلة حول واجهة برمجة تطبيقات humanizer بالذكاء الاصطناعي
احصل على مفتاح API الخاص بك
تُصدر المفاتيح لكل مشروع. صف ما تبنيه وسنرد خلال 24 ساعة.