AI Humanizer واجهة برمجة التطبيقات
أنسِن نص AI داخل منتجك باستدعاء REST واحد. تتيح واجهة برمجة تطبيقات مُنسِّق النصوص بالذكاء الاصطناعي المحرك الذي يشغّل 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" }}ما الذي تتكفله واجهة برمجة تطبيقات مُنسِّق النصوص بالذكاء الاصطناعي نيابةً عنك
توجيه اللغة، والتحكم في النبرة، والقياس، وأمان إعادة المحاولة كلها جزء من نقطة النهاية، لذا يظل تكاملك دالة واحدة.
مسار واحد يغطي أكثر من 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%.
خفض درجة الذكاء الاصطناعي مقابل الأمانة الدلالية مقابل القواعد النحوية
- خفض درجة الذكاء الاصطناعي (GPTZero، %)
- الوفاء الدلالي (دعم NLI × 100)
- القواعد النحوية (LanguageTool يحدد الأخطاء لكل 1,000 كلمة)
معلمة واحدة
اضبط intensityScalar على 1.25 في الطلب الذي ترسله بالفعل. يبقى كل من نقطة النهاية ومفتاح Bearer واستجابة JSON كما هي.
إعادة الصياغة القصوى
يعيد ULTRA صياغة جزء أكبر من كل فقرة مقارنة بأي إعداد آخر، مع أعلى خفض في درجة الذكاء الاصطناعي، وذلك على حساب انخفاض طفيف في قابلية القراءة والقواعد. راجع الناتج قبل الإرسال.
نص إنجليزي فقط
ULTRA يعمل على النص الإنجليزي فقط. الإعدادات الخمسة الأخرى تغطي كل لغة تدعمها واجهة برمجة التطبيقات.
يتم احتساب الفاتورة لكل كلمة مُدخلة
تُحتسب طلبات ULTRA لكل كلمة إدخال، مثل أي إعداد آخر، وإذا فشل المحرك في إكمال طلب ما، تُعاد كلماته إلى رصيدك تلقائيًا.
مرجع نقطة النهاية
Authorization: Bearer. تبدأ المفاتيح بـ tp_live_ وتُصدر لكل مشروع./api/v1/humanize/api/v1/balanceيقبل استدعاء humanize واحد حتى 1,000 كلمة ضمن حد 10,000 حرف، ويمكن لكل مفتاح إصدار 60 طلبًا في الدقيقة. تُرسل المستندات الأطول كسلسلة من الاستدعاءات.
معلمات الطلب
المطلوب فقط هو text. كل شيء آخر له قيمة افتراضية مناسبة، لذا فإن التكامل الأدنى لا يتطلب سوى حقل واحد.
| المعلمة | Type | الحضور | ملاحظات |
|---|---|---|---|
text | string | مطلوب | النص المراد humanize. حتى 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 أو 1.25. مدى ابتعاد إعادة الصياغة عن النص الأصلي، من خفيف عبر متوازن ومكثف إلى ULTRA. يعمل ULTRA (1.25) على النص الإنجليزي فقط. |
language | string | اختياري | يوجّه النص غير الإنجليزي إلى المسار متعدد اللغات. اتركه فارغًا، أو أرسل الإنجليزية، للحصول على المحرك الإنجليزي المضبوط بدقة. |
englishVariant | string | اختياري | أمريكي أو بريطاني. يحافظ على الإملاء والمفردات على جانب واحد من الأطلسي. |
freezeTerms | string[] | اختياري | حتى 10 مصطلحات أو عبارات تُحفظ حرفيًا أثناء إعادة الصياغة: أسماء الإنشاءات، الأدوات، أسماء المنتجات. |
removeEmDashes | boolean | اختياري | يعيد صياغة تراكيب الشرطة الطويلة em dash إلى علامات ترقيم تقليدية. |
requestId | string | موصى به | رمز idempotency الخاص بك. يؤدي تكراره خلال نحو عشر دقائق إلى إعادة الاستجابة المخزنة بدلًا من احتساب رسوم مرة أخرى. |
حقول الاستجابة
outputTextالنص المعاد humanize.metrics.inputWords / outputWordsعدد الكلمات المستلمة وعدد الكلمات المعادة. غالبًا ما تكون عمليات إعادة الصياغة أطول قليلًا من المصدر.metrics.wordsChargedتكلفة هذا الاستدعاء. تساوي دائمًا عدد الكلمات المدخلة، وليس عدد الكلمات الناتجة.metrics.balanceRemainingرصيد الكلمات المتبقي على المفتاح بعد هذا الاستدعاء، حتى تتمكن من القياس دون طلب ثانٍ.metrics.modelLatencyMs / routeزمن المحرك لإعادة الصياغة والمسار الذي قدّمها.keptLinesالعناوين والقوائم والجداول والمعادلات والمراجع التي أُعيدت كما هي تمامًا. تظهر فقط عندما يحتوي النص على مثل هذه الأسطر.الأخطاء وإعادة المحاولة
كل خطأ يعيد JSON مع error.code ثابت ورسالة قابلة للقراءة البشرية. القاعدة التي ينبغي التصميم وفقها: لا تُحاسَب إلا على إعادة صياغة تم تسليمها، وإعادة المحاولة باستخدام requestId نفسه تكون آمنة دائمًا.
UNAUTHORIZEDمفتاح API مفقود أو غير معرّف. تحقّق من ترويسة Authorization: Bearer.INSUFFICIENT_BALANCEلا توجد رصيد كلمات كافٍ على المفتاح. تتضمن الاستجابة الرصيد المتاح.REQUEST_IN_PROGRESSما زال الطلب الذي يحمل requestId قيد المعالجة. انتظر اكتماله بدلًا من منافسته.TOO_LONG / VALIDATION_FAILEDيتجاوز الإدخال حد 1,000 كلمة أو أن إحدى المعلمات غير صحيحة. تسرد الاستجابة المشكلات الدقيقة.ENGINE_ERRORتعذر تشغيل المحرك أو انتهت المهلة. الكلمات أُعيدت بالفعل إلى رصيدك، أعد المحاولة باستخدام requestId نفسه.INSUFFICIENT_PROSEيحتوي النص على 50 كلمة أو أقل من فقرات النص الأساسية بجوار العناوين أو القوائم أو الجداول أو المعادلات أو المراجع، لذا فالمحتوى قليل جدًا لإعادة الصياغة. لا تُفرض أي رسوم؛ أضف مزيدًا من الفقرات ثم أعد المحاولة.ما الذي تبنيه الفرق على واجهة برمجة التطبيقات humanizer
منصات EdTech والكتابة
أضف إجراء humanize إلى جانب ميزات التدقيق النحوي أو إعادة الصياغة الحالية لديك. يحافظ وضع Academic على الاستشهادات كما هي، لذلك لا تحتاج الأدوات الموجهة للطلاب إلى حذف المراجع قبل إرسال النص.
أدوات المستندات والتدقيق اللغوي
مرِّر المستندات كاملة على دفعات من 1,000 كلمة ثم أعد تجميعها. تثبّت Freeze terms الأسماء والمصطلحات عبر الدفعات، وتتيح المحاولات المعادة عديمة الأثر إعادة تشغيل مسارات المعالجة الدفعية بأمان.
منتجات المحتوى وSEO
يعيد وضع Blog/SEO صياغة المسودات إلى نثر صالح للنشر، بينما تثبّت Freeze terms الكلمات المفتاحية المستهدفة، بحيث يحتفظ النص بقصد البحث ويفقد الإيقاع الآلي.
شركاء العلامة البيضاء
تعمل نقطة النهاية بشكل غير مرئي داخل منتجك: واجهتك، وفوترةك، ومحركنا. تُسعَّر ترتيبات الشراكة وفق الحجم الشهري عبر نموذج الوصول.
تسعير واجهة برمجة تطبيقات مُنسِّق النصوص بالذكاء الاصطناعي
يتم سحب الرصيد مسبقا حسب عدد الكلمات. يحدد الفوترة ما ترسله أنت، وليس ما يعيده المحرك، وأي استدعاء يفشل في إنتاج إعادة صياغة يُعاد رصيده إلى المفتاح.
تكون الاعتمادات صالحة لمدة 12 شهرًا من تاريخ الشراء، وتغطي كل لغة وكل نمط كتابة وكل صيغة إنجليزية يدعمها الطرفية. ولأحجام الاستخدام المستمرة أو لترتيب white-label داخل منتجك الخاص، اطلب الوصول وسنقدم عرضًا بناءً على رقمك الشهري.
احصل على مفتاح API الخاص بك
تُصدر المفاتيح لكل مشروع. صف ما تبنيه وسنرد خلال 24 ساعة.