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

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

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

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

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

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

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

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

ULTRANEW!

ULTRA: أعلى خفض لدرجة الذكاء الاصطناعي عبر واجهة برمجة التطبيقات

يعمل إعداد الشدة السادس الجديد على نقطة النهاية نفسها. اضبط intensityScalar على 1.25 لـ ULTRA، وهو الحد الأقصى لإعادة الصياغة في المحوّل إلى نص بشري، مع معدل خفض درجة GPTZero بنسبة 89%.

خفض درجة الذكاء الاصطناعي مقابل الأمانة الدلالية مقابل القواعد النحوية

025507510050%59%68%76%78%89%خفيفمتوسطمتوازنقويمكثفULTRA
  • خفض درجة الذكاء الاصطناعي (GPTZero، %)
  • الوفاء الدلالي (دعم NLI × 100)
  • القواعد النحوية (LanguageTool يحدد الأخطاء لكل 1,000 كلمة)
من خفيف إلى Ultra، يزداد خفض درجة الذكاء الاصطناعي من 50% إلى 89%. يزداد خفض درجة الذكاء الاصطناعي على حساب انخفاض طفيف في الأمانة الدلالية، والقواعد، وقابلية القراءة العامة.

معلمة واحدة

اضبط intensityScalar على 1.25 في الطلب الذي ترسله بالفعل. يبقى كل من نقطة النهاية ومفتاح Bearer واستجابة JSON كما هي.

إعادة الصياغة القصوى

يعيد ULTRA صياغة جزء أكبر من كل فقرة مقارنة بأي إعداد آخر، مع أعلى خفض في درجة الذكاء الاصطناعي، وذلك على حساب انخفاض طفيف في قابلية القراءة والقواعد. راجع الناتج قبل الإرسال.

نص إنجليزي فقط

ULTRA يعمل على النص الإنجليزي فقط. الإعدادات الخمسة الأخرى تغطي كل لغة تدعمها واجهة برمجة التطبيقات.

يتم احتساب الفاتورة لكل كلمة مُدخلة

تُحتسب طلبات ULTRA لكل كلمة إدخال، مثل أي إعداد آخر، وإذا فشل المحرك في إكمال طلب ما، تُعاد كلماته إلى رصيدك تلقائيًا.

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

تقرأ كلتا الطريقتين مفتاحك من ترويسة 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 أو 1.25. مدى ابتعاد إعادة الصياغة عن النص الأصلي، من خفيف عبر متوازن ومكثف إلى ULTRA. يعمل ULTRA (1.25) على النص الإنجليزي فقط.
languagestringاختيارييوجّه النص غير الإنجليزي إلى المسار متعدد اللغات. اتركه فارغًا، أو أرسل الإنجليزية، للحصول على المحرك الإنجليزي المضبوط بدقة.
englishVariantstringاختياريأمريكي أو بريطاني. يحافظ على الإملاء والمفردات على جانب واحد من الأطلسي.
freezeTermsstring[]اختياريحتى 10 مصطلحات أو عبارات تُحفظ حرفيًا أثناء إعادة الصياغة: أسماء الإنشاءات، الأدوات، أسماء المنتجات.
removeEmDashesbooleanاختيارييعيد صياغة تراكيب الشرطة الطويلة em dash إلى علامات ترقيم تقليدية.
requestIdstringموصى بهرمز idempotency الخاص بك. يؤدي تكراره خلال نحو عشر دقائق إلى إعادة الاستجابة المخزنة بدلًا من احتساب رسوم مرة أخرى.

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

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

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

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

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

ما الذي تبنيه الفرق على واجهة برمجة التطبيقات 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 بالذكاء الاصطناعي