AI Humanizer API
ایک ہی REST call سے اپنے پروڈکٹ میں AI متن انسانی بنائیں۔ AI humanizer API وہ engine فراہم کرتا ہے جو TextPulse کو آپ کے backend تک طاقت دیتا ہے: JSON اندر جاتا ہے، rewritten نثر واپس آتی ہے، 60 سے زائد زبانوں میں۔
اپنی پہلی درخواست بنانا
ایک Authorization: Bearer header کے ساتھ authenticate کریں اور اپنا متن post کریں۔ rewritten version outputText کے طور پر، اس call کے metering figures کے ساتھ واپس آتا ہے۔
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 API آپ کے لیے کیا سنبھالتا ہے
Language routing، register control، metering اور retry safety endpoint کا حصہ ہیں، اس لیے آپ کا integration ایک ہی function رہتا ہے۔
ایک route 60+ زبانوں کا احاطہ کرتا ہے
English fine-tuned humanizer engine پر چلتا ہے۔ language value دیں اور request اس کے بجائے multilingual path پر route ہو جاتی ہے، اس طرح non-English product page دوسری integration کے بغیر اسی endpoint تک پہنچتی ہے۔
Register اور strength parameters ہیں
پانچ writing modes Academic، Corporate، Creative، Blog/SEO اور General registers کا احاطہ کرتے ہیں۔ intensityScalar value یہ طے کرتی ہے کہ rewrite source سے کتنی مختلف ہو، اور 0، 0.25، 0.5، 0.75 یا 1 میں سے ایک لیتی ہے، Mild سے شروع ہو کر 0.5 پر Balanced default تک اور پھر Aggressive تک۔
ہر document کے لیے ایک POST
نہ کوئی job queue ہے جسے poll کیا جائے اور نہ کوئی webhook register کرنے کی ضرورت ہے۔ humanize call connection کو اس وقت تک برقرار رکھتا ہے جب تک model واپس نہ آئے اور rewritten text کے ساتھ جواب نہ دے، اس طرح ایک ہی request کام مکمل کرتی ہے۔
Retries پر دو بار charge نہیں ہوتا
ایک requestId بھیجیں، اور نتیجہ تقریباً دس منٹ کے لیے اس کے خلاف cache ہو جاتا ہے۔ اسی ونڈو کے اندر اسی identifier کی دوبارہ کال model کو دوبارہ چلانے کے بجائے محفوظ جواب کو دوبارہ چلا دیتی ہے، اور اگر engine کوئی request مکمل کرنے میں ناکام ہو جائے تو اس کے الفاظ خود بخود آپ کے balance میں واپس آ جاتے ہیں۔
Endpoint reference
Authorization: Bearer header سے پڑھتے ہیں۔ Keys tp_live_ سے شروع ہوتی ہیں اور ہر project کے لیے جاری کی جاتی ہیں۔/api/v1/humanize/api/v1/balanceایک humanize call 1,000 words تک، 10,000 character ceiling کے اندر، قبول کرتا ہے، اور ہر key فی منٹ 60 requests جاری کر سکتی ہے۔ طویل documents calls کی ایک sequence کے طور پر بھیجے جاتے ہیں۔
Request parameters
صرف text درکار ہے۔ باقی سب کی معقول default موجود ہے، اس لیے کم سے کم integration ایک ہی field پر مشتمل ہے۔
| Parameter | Type | Presence | Notes |
|---|---|---|---|
text | string | Required | Humanize کرنے کے لیے متن۔ ہر request میں 10,000 character کی حد کے اندر 1,000 words تک۔ |
writingMode | string | Default: Academic | Academic, Corporate, Creative, Blog/SEO یا General میں سے ایک۔ وہ register متعین کرتا ہے جس پر rewrite قائم رہتی ہے۔ |
intensityScalar | number | Default: 0.5 | 0, 0.25, 0.5, 0.75 یا 1 میں سے ایک۔ Rewrite source سے کتنی دور جائے، Mild سے Balanced ہوتے ہوئے Aggressive تک۔ |
language | string | Optional | غیر انگریزی متن کو multilingual path کی طرف بھیجتا ہے۔ fine-tuned English engine کے لیے اسے شامل نہ کریں، یا English بھیجیں۔ |
englishVariant | string | Optional | American یا British۔ ہجے اور vocabulary کو بحرِ اوقیانوس کے ایک جانب رکھتا ہے۔ |
freezeTerms | string[] | Optional | دوبارہ لکھنے کے دوران زیادہ سے زیادہ 10 اصطلاحات یا فقرے کو عین وہی محفوظ رکھا جاتا ہے: construct names, instruments, product names۔ |
removeEmDashes | boolean | Optional | em dash constructions کو روایتی punctuation میں دوبارہ لکھتا ہے۔ |
requestId | string | Recommended | آپ کا idempotency token۔ اسے تقریباً دس منٹ کے اندر دوبارہ بھیجنے سے دوبارہ چارج کرنے کے بجائے محفوظ شدہ response واپس چلتا ہے۔ |
Response fields
outputTextHumanized متن۔metrics.inputWords / outputWordsموصول ہونے والے words اور واپس کیے گئے words۔ Rewrites اکثر source سے قدرے طویل ہوتی ہیں۔metrics.wordsChargedCall کی لاگت۔ ہمیشہ input count کے برابر، کبھی output count کے برابر نہیں۔metrics.balanceRemainingاس call کے بعد key پر باقی word credits، تاکہ آپ دوسری request کے بغیر meter کر سکیں۔metrics.modelLatencyMs / routeRewrite کے لیے engine time اور وہ path جس نے اسے serve کیا۔Errors and retries
ہر error JSON کے ساتھ ایک مستحکم error.code اور ایک انسانی طور پر قابلِ فہم message واپس کرتا ہے۔ جس اصول پر design کرنا چاہیے وہ یہ ہے: آپ سے صرف اسی rewrite کی charge لی جاتی ہے جو deliver ہوئی ہو، اور ایک ہی requestId کے ساتھ retry کرنا ہمیشہ محفوظ ہے۔
UNAUTHORIZEDAPI key غائب ہے یا پہچانی نہیں گئی۔ Authorization: Bearer header چیک کریں۔INSUFFICIENT_BALANCEkey پر کافی word credits موجود نہیں۔ response میں دستیاب balance شامل ہوتا ہے۔REQUEST_IN_PROGRESSاس requestId والی درخواست ابھی پروسیس ہو رہی ہے۔ اسے ریس کرنے کے بجائے اس کے مکمل ہونے کا انتظار کریں۔TOO_LONG / VALIDATION_FAILEDinput 1,000-word حد کو توڑتا ہے یا کوئی parameter malformed ہے۔ response میں درست مسائل درج ہوتے ہیں۔ENGINE_ERRORengine ناکام ہو گیا یا timeout ہو گیا۔ words پہلے ہی آپ کے balance میں واپس آ چکے ہیں، اسی requestId کے ساتھ retry کریں۔اینڈپوائنٹ کے پیچھے موجود انجن
ہر کال شائع شدہ TextPulse انجن پر چلتی ہے، جسے 2,000 دستاویزات پر مشتمل علمی کارپس پر ناپا گیا ہے اور جب بھی شناختی ماڈلز اپ ڈیٹ ہوتے ہیں، اسے دوبارہ چلایا جاتا ہے۔ ڈیٹیکٹر کے لحاظ سے کم اسکور ریٹس:
وینڈر کے ذریعے ماپے گئے اعداد و شمار، ان کے کارپس کے ساتھ شائع کیے گئے۔ کوئی بھی humanizer کسی مخصوص دستاویز پر detector کے نتیجے کا وعدہ نہیں کر سکتا، اس لیے اپنی مصنوعات کی میسجنگ کو پیمائش پر بنائیں، ضمانت پر نہیں۔
ٹیمیں humanizer API پر کیا بناتی ہیں
EdTech اور تحریری پلیٹ فارمز
اپنی موجودہ گرامر یا پیرا فریز خصوصیات کے ساتھ humanize ایکشن شامل کریں۔ Academic mode اقتباسات کو برقرار رکھتا ہے، اس لیے طلبہ کے لیے بنائے گئے tools کو متن بھیجنے سے پہلے حوالہ جات ہٹانے کی ضرورت نہیں ہوتی۔
دستاویز اور پروف ریڈنگ tools
پورے دستاویزات کو 1,000-لفظی حصوں میں گزاریں اور دوبارہ جوڑیں۔ Freeze terms حصوں کے درمیان ناموں اور اصطلاحات کو مستحکم رکھتے ہیں، اور idempotent retries بیچ پائپ لائنز کو دوبارہ چلانے کے لیے محفوظ بناتے ہیں۔
مواد اور SEO مصنوعات
Blog/SEO mode مسودوں کو اشاعت کے قابل نثر میں دوبارہ لکھتا ہے، جبکہ freeze terms ہدفی keywords کو مقفل رکھتے ہیں، تاکہ متن اپنی تلاش کی نیت برقرار رکھے اور مشینی آہنگ کھو دے۔
White-label partners
یہ endpoint آپ کی پروڈکٹ کے اندر غیر محسوس طور پر چلتا ہے, آپ کا interface, آپ کی billing, ہمارا engine. Partner arrangements access form کے ذریعے ماہانہ volume کے مطابق quote کیے جاتے ہیں۔
AI ہیومنائزر API قیمتیں
کریڈٹس پہلے سے ادا کیے جاتے ہیں اور لفظ بہ لفظ کٹوتی ہوتے ہیں۔ بلنگ اس بات کو گنتی ہے کہ آپ کیا بھیجتے ہیں، انجن کی طرف سے کیا واپس آتا ہے نہیں، اور کوئی بھی کال جو ری رائٹ پیدا کرنے میں ناکام ہو، اس کی کریڈٹ واپس اسی کلید پر کر دی جاتی ہے۔
کریڈٹس خریداری کے بعد 12 ماہ تک معتبر رہتے ہیں، اور endpoint کے ذریعے معاونت یافتہ ہر زبان، writing mode اور English variant کا احاطہ کرتے ہیں۔ مسلسل حجم یا اپنے ہی product کے اندر white-label arrangement کے لیے، access کی درخواست کریں اور ہم آپ کے ماہانہ figure کے مطابق quote دیں گے۔
اپنی API key حاصل کریں
Keys ہر project کے لیے جاری کی جاتی ہیں۔ آپ کیا بنا رہے ہیں اس کی وضاحت کریں اور ہم 24 hours کے اندر جواب دیں گے۔