مُصمَّم للمطورين

AI Humanizer واجهة برمجة التطبيقات

أنسِن نص AI داخل منتجك باستدعاء REST واحد. تتيح واجهة برمجة تطبيقات مُنسِّق النصوص بالذكاء الاصطناعي المحرك الذي يشغّل TextPulse لواجهة الخلفية لديك: يدخل JSON، ويعود نثر مُعاد الصياغة، عبر أكثر من 60 لغة.

طلب وصول إلى واجهة برمجة التطبيقاتاقرأ المثال
POSThttps://textpulse.ai/api/v1/humanize

إجراء طلبك الأول

صادِق باستخدام ترويسة 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  }'
200 OKapplication/json
{  "outputText": "Our analysis points to measurable gains from the...",  "metrics": {    "inputWords": 128, "outputWords": 134,    "wordsCharged": 128, "balanceRemaining": 99872,    "modelLatencyMs": 4310, "route": "v1/humanize"  }}

ما الذي تتكفله واجهة برمجة تطبيقات مُنسِّق النصوص بالذكاء الاصطناعي نيابةً عنك

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

مسار واحد يغطي أكثر من 60 لغة

يعمل English على محرك التأنيس المضبوط بدقة. مرِّر قيمة اللغة، فيُوجَّه الطلب إلى المسار متعدد اللغات بدلًا من ذلك، بحيث يصل صفحة منتج غير إنجليزية إلى نقطة النهاية نفسها دون تكامل ثانٍ.

النبرة والقوة معلمتان

تغطي خمسة أنماط كتابة السجلات الأكاديمية، والشركات، والإبداعية، والمدونات/SEO، والعامة. تضبط قيمة intensityScalar مقدار اختلاف إعادة الصياغة عن النص الأصلي، وتأخذ إحدى القيم 0 أو 0.25 أو 0.5 أو 0.75 أو 1، من Mild مرورًا بالافتراضي Balanced عند 0.5 وصولًا إلى Aggressive.

طلب POST واحد لكل مستند

لا توجد قائمة مهام تنتظر الاستطلاع، ولا webhook لتسجيله. يبقي استدعاء humanize الاتصال مفتوحًا حتى يعيد النموذج النتيجة، ثم يجيب بالنص المُعاد صياغته، لذا ينجز طلب واحد العمل.

إعادة المحاولة لا تُحتسب مرتين

أرسل requestId وسيتم تخزين النتيجة مؤقتًا بناء عليه لمدة تقارب 10 دقائق. يؤدي تكرار المعرّف نفسه داخل تلك النافذة إلى إعادة تشغيل الاستجابة المخزنة بدلًا من تشغيل النموذج مرة أخرى، وأي طلب يفشل المحرك في إكماله يعيد كلماته تلقائيًا إلى رصيدك.

مرجع نقطة النهاية

تقرأ كلتا الطريقتين مفتاحك من ترويسة Authorization: Bearer. تبدأ المفاتيح بـ tp_live_ وتُصدر لكل مشروع.
POST/api/v1/humanize
أعِد صياغة النص المُولَّد بالذكاء الاصطناعي إلى نثر طبيعي.
GET/api/v1/balance
اقرأ رصيد الكلمات المتبقي على مفتاحك.

يقبل استدعاء humanize واحد حتى 1,000 كلمة ضمن حد 10,000 حرف، ويمكن لكل مفتاح إصدار 60 طلبًا في الدقيقة. تُرسل المستندات الأطول كسلسلة من الاستدعاءات.

معلمات الطلب

المطلوب فقط هو text. كل شيء آخر له قيمة افتراضية مناسبة، لذا فإن التكامل الأدنى لا يتطلب سوى حقل واحد.

المعلمةTypeالحضورملاحظات
textstringمطلوبالنص المراد humanize. حتى 1,000 كلمة ضمن حد أقصى قدره 10,000 حرف لكل طلب.
writingModestringالافتراضي: Academicأحد الخيارات Academic أو Corporate أو Creative أو Blog/SEO أو General. يحدد السجل الذي تحافظ عليه إعادة الصياغة.
intensityScalarnumberالافتراضي: 0.5أحد الخيارات 0 أو 0.25 أو 0.5 أو 0.75 أو 1. مدى ابتعاد إعادة الصياغة عن المصدر، من Mild عبر Balanced إلى Aggressive.
languagestringاختيارييوجّه النص غير الإنجليزي إلى المسار متعدد اللغات. اتركه فارغًا، أو أرسل الإنجليزية، للحصول على المحرك الإنجليزي المضبوط بدقة.
englishVariantstringاختياريأمريكي أو بريطاني. يحافظ على الإملاء والمفردات على جانب واحد من الأطلسي.
freezeTermsstring[]اختياريحتى 10 مصطلحات أو عبارات تُحفظ حرفيًا أثناء إعادة الصياغة: أسماء الإنشاءات، الأدوات، أسماء المنتجات.
removeEmDashesbooleanاختيارييعيد صياغة تراكيب الشرطة الطويلة em dash إلى علامات ترقيم تقليدية.
requestIdstringموصى بهرمز idempotency الخاص بك. يؤدي تكراره خلال نحو عشر دقائق إلى إعادة الاستجابة المخزنة بدلًا من احتساب رسوم مرة أخرى.

حقول الاستجابة

outputTextالنص المعاد humanize.
metrics.inputWords / outputWordsعدد الكلمات المستلمة وعدد الكلمات المعادة. غالبًا ما تكون عمليات إعادة الصياغة أطول قليلًا من المصدر.
metrics.wordsChargedتكلفة هذا الاستدعاء. تساوي دائمًا عدد الكلمات المدخلة، وليس عدد الكلمات الناتجة.
metrics.balanceRemainingرصيد الكلمات المتبقي على المفتاح بعد هذا الاستدعاء، حتى تتمكن من القياس دون طلب ثانٍ.
metrics.modelLatencyMs / routeزمن المحرك لإعادة الصياغة والمسار الذي قدّمها.

الأخطاء وإعادة المحاولة

كل خطأ يعيد JSON مع error.code ثابت ورسالة قابلة للقراءة البشرية. القاعدة التي ينبغي التصميم وفقها: لا تُحاسَب إلا على إعادة صياغة تم تسليمها، وإعادة المحاولة باستخدام requestId نفسه تكون آمنة دائمًا.

401UNAUTHORIZEDمفتاح API مفقود أو غير معرّف. تحقّق من ترويسة Authorization: Bearer.
402INSUFFICIENT_BALANCEلا توجد رصيد كلمات كافٍ على المفتاح. تتضمن الاستجابة الرصيد المتاح.
409REQUEST_IN_PROGRESSما زال الطلب الذي يحمل requestId قيد المعالجة. انتظر اكتماله بدلًا من منافسته.
422TOO_LONG / VALIDATION_FAILEDيتجاوز الإدخال حد 1,000 كلمة أو أن إحدى المعلمات غير صحيحة. تسرد الاستجابة المشكلات الدقيقة.
5xxENGINE_ERRORتعذر تشغيل المحرك أو انتهت المهلة. الكلمات أُعيدت بالفعل إلى رصيدك، أعد المحاولة باستخدام requestId نفسه.

المحرك الذي يقف خلف نقطة النهاية

تُشغَّل كل عملية على محرك TextPulse المنشور، وقد قيس على مجموعة أكاديمية تضم 2,000 وثيقة، ثم أُعيد تشغيله مع تحديث نماذج الكشف. معدلات انخفاض الدرجة حسب الكاشف:

92.33%
Turnitin AI
89.12%
Originality.ai
87.91%
GPTZero

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

ما الذي تبنيه الفرق على واجهة برمجة التطبيقات humanizer

منصات EdTech والكتابة

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

أدوات المستندات والتدقيق اللغوي

مرِّر المستندات كاملة على دفعات من 1,000 كلمة ثم أعد تجميعها. تثبّت Freeze terms الأسماء والمصطلحات عبر الدفعات، وتتيح المحاولات المعادة عديمة الأثر إعادة تشغيل مسارات المعالجة الدفعية بأمان.

منتجات المحتوى وSEO

يعيد وضع Blog/SEO صياغة المسودات إلى نثر صالح للنشر، بينما تثبّت Freeze terms الكلمات المفتاحية المستهدفة، بحيث يحتفظ النص بقصد البحث ويفقد الإيقاع الآلي.

شركاء العلامة البيضاء

تعمل نقطة النهاية بشكل غير مرئي داخل منتجك: واجهتك، وفوترةك، ومحركنا. تُسعَّر ترتيبات الشراكة وفق الحجم الشهري عبر نموذج الوصول.

تسعير واجهة برمجة تطبيقات مُنسِّق النصوص بالذكاء الاصطناعي

يتم سحب الرصيد مسبقا حسب عدد الكلمات. يحدد الفوترة ما ترسله أنت، وليس ما يعيده المحرك، وأي استدعاء يفشل في إنتاج إعادة صياغة يُعاد رصيده إلى المفتاح.

Starter
$28
100K كلمات
$0.28 لكل 1,000 كلمة
Growth
$125
500K كلمات
$0.25 لكل 1,000 كلمة
Pro
$440
2M كلمات
$0.22 لكل 1,000 كلمة
أفضل قيمةScale
$2,000
10M كلمات
$0.20 لكل 1,000 كلمة

تكون الاعتمادات صالحة لمدة 12 شهرًا من تاريخ الشراء، وتغطي كل لغة وكل نمط كتابة وكل صيغة إنجليزية يدعمها الطرفية. ولأحجام الاستخدام المستمرة أو لترتيب white-label داخل منتجك الخاص، اطلب الوصول وسنقدم عرضًا بناءً على رقمك الشهري.

احصل على مفتاح API الخاص بك

تُصدر المفاتيح لكل مشروع. صف ما تبنيه وسنرد خلال 24 ساعة.

تُستخدم تفاصيلك لتوفير المفتاح فقط، ولا لشيء آخر.

أسئلة حول واجهة برمجة تطبيقات humanizer بالذكاء الاصطناعي