AI Humanizer API
متن AI را در محصول خود با یک فراخوان REST انسانی کنید. API انسانساز AI موتورِ پشت TextPulse را در اختیار backend شما میگذارد: 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" }}API انسانساز AI چه کارهایی را برای شما انجام میدهد
مسیریابی زبان، کنترل register، سنجش و ایمنی در برابر retry بخشی از endpoint هستند، بنابراین یکپارچهسازی شما در قالب یک تابع باقی میماند.
یک مسیر برای بیش از 60 زبان
English روی موتور انسانساز fine-tuned اجرا میشود. یک مقدار language ارسال کنید و درخواست بهجای آن به مسیر چندزبانه هدایت میشود، بنابراین یک صفحه محصول غیرانگلیسی بدون یک یکپارچهسازی دوم به همان endpoint میرسد.
register و شدت بهصورت پارامتر
پنج حالت نوشتن، ثبتهای آکادمیک، شرکتی، خلاقانه، وبلاگ/سئو و عمومی را پوشش میدهند. مقدار intensityScalar میزان تفاوت بازنویسی با متن اصلی را تعیین میکند و یکی از 0، 0.25، 0.5، 0.75، 1 یا 1.25 را میگیرد، از ملایم تا مقدار پیشفرض متعادل در 0.5 و تهاجمی در 1، و تا ULTRA در 1.25.
یک POST برای هر سند
هیچ صف کاری برای poll کردن و هیچ webhookی برای ثبت وجود ندارد. فراخوان humanize اتصال را تا بازگشت model باز نگه میدارد و با متن بازنویسیشده پاسخ میدهد، بنابراین یک درخواست واحد کار را کامل میکند.
retryها دوبار هزینه ندارند
یک requestId ارسال کنید و نتیجه حدود ده دقیقه در برابر آن کش می شود. تکرار همان شناسه داخل این بازه، پاسخ ذخیره شده را پخش می کند، نه این که دوباره مدل اجرا شود، و هر درخواستی که موتور نتواند آن را کامل کند، کلماتش را به طور خودکار به موجودی شما برمی گرداند.
ULTRANEW!
ULTRA: بالاترین کاهش امتیاز هوش مصنوعی از طریق API
تنظیم شدت ششم جدید روی همان endpoint کار میکند. intensityScalar را برای ULTRA، حداکثر بازنویسی انسانساز، روی 1.25 تنظیم کنید، با نرخ کاهش امتیاز GPTZero برابر با 89٪.
کاهش امتیاز AI در برابر وفاداری معنایی در برابر دستور زبان
- کاهش امتیاز AI (GPTZero, %)
- وفاداری معنایی (پشتیبانی NLI × 100)
- دستور زبان (LanguageTool به ازای هر ۱,۰۰۰ کلمه علامتگذاری میکند)
یک پارامتر
intensityScalar را در درخواستی که از قبل ارسال میکنید روی 1.25 تنظیم کنید. نقطه پایانی، کلید Bearer و پاسخ JSON بدون تغییر میمانند.
حداکثر بازنویسی
ULTRA بیش از هر تنظیم دیگری از هر پاراگراف بازنویسی میکند، با بالاترین کاهش امتیاز AI، اما به قیمت خوانایی و دستور زبان اندکی پایینتر. پیش از ارسال، خروجی را بازبینی کنید.
فقط متن انگلیسی
ULTRA فقط روی متن انگلیسی کار میکند. پنج تنظیم دیگر همه زبانهایی را که API پشتیبانی میکند پوشش میدهند.
به ازای هر کلمه ورودی صورتحساب میشود
یک درخواست ULTRA به ازای هر واژه ورودی محاسبه میشود، درست مانند هر تنظیم دیگر، و اگر موتور نتواند یک درخواست را کامل کند، واژههای آن بهطور خودکار به موجودی شما بازگردانده میشوند.
مرجع endpoint
Authorization: Bearer میخوانند. کلیدها با tp_live_ آغاز میشوند و برای هر project صادر میشوند./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 یا 1.25. میزان فاصله بازنویسی از متن اصلی، از ملایم تا متعادل و تهاجمی و ULTRA. ULTRA (1.25) فقط روی متن انگلیسی کار میکند. |
language | string | اختیاری | متن غیرانگلیسی را به مسیر چندزبانه هدایت میکند. برای موتور انگلیسیِ تنظیمشده، آن را حذف کنید یا متن انگلیسی بفرستید. |
englishVariant | string | اختیاری | آمریکایی یا بریتانیایی. املا و واژگان را به یکی از دو سوی اقیانوس اطلس محدود میکند. |
freezeTerms | string[] | اختیاری | تا ۱۰ عبارت یا عبارت کلیدی به صورت دقیق در بازنویسی حفظ می شوند: نام های سازنده، سازها، نام های محصول. |
removeEmDashes | boolean | اختیاری | ساختارهای em dash را به نشانهگذاری متعارف بازنویسی میکند. |
requestId | string | توصیهشده | نشانه idempotency شما. تکرار آن در حدود ده دقیقه، بهجای دریافت هزینه دوباره، پاسخ ذخیرهشده را بازپخش میکند. |
فیلدهای پاسخ
outputTextمتن انسانسازیشده.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متن در کنار تیترها، فهرستها، جدولها، معادلهها یا ارجاعات، ۵۰ واژه یا کمتر از بندهای متنِ اصلی دارد، بنابراین برای انسانیسازی بسیار کم است. هیچ هزینهای دریافت نمیشود؛ بندهای بیشتری اضافه کنید و دوباره تلاش کنید.تیمها با API humanizer چه میسازند
EdTech و پلتفرمهای نوشتن
یک اقدام humanize را در کنار قابلیتهای موجود grammar یا paraphrase خود اضافه کنید. حالت Academic citations را دستنخورده نگه میدارد، بنابراین ابزارهای روبهروی دانشجو لازم نیست پیش از ارسال متن، references را حذف کنند.
ابزارهای پردازش و proofreading اسناد
اسناد کامل را در بخشهای 1,000 واژهای عبور دهید و دوباره سرهم کنید. freeze terms نامها و اصطلاحات را در سراسر بخشها ثابت نگه میدارند، و retryهای idempotent اجرای دوباره خطوط لوله batch را ایمن میکنند.
محصولات محتوا و SEO
حالت Blog/SEO پیشنویسها را به نثری قابل انتشار بازنویسی میکند، در حالی که freeze terms کلیدواژههای هدف را قفل میکنند، بنابراین متن، قصد جستوجوی خود را حفظ میکند و آهنگ ماشینی خود را از دست میدهد.
شرکای white-label
این endpoint بهصورت نامرئی درون محصول شما اجرا میشود: رابط شما، صورتحساب شما، موتور ما. ترتیبات مشارکتی بر اساس حجم ماهانه و از طریق فرم دسترسی قیمتگذاری میشوند.
قیمتگذاری API انسانساز AI
اعتبارها از قبل پرداخت می شوند و به ازای هر کلمه برداشت می شوند. صورتحساب میزان چیزی را که ارسال می کنید محاسبه می کند، نه چیزی را که موتور برمی گرداند، و هر فراخوانی که نتواند بازنویسی تولید کند، به کلید مربوطه به حساب شما بازگردانده می شود.
اعتبارها از زمان خرید به مدت 12 ماه معتبر هستند و همه زبانها، حالتهای نوشتن و گونههای انگلیسی پشتیبانیشده توسط endpoint را پوشش میدهند. برای حجم پایدار یا یک arrangement با white-label درون محصول خودتان، دسترسی را درخواست کنید و ما بر اساس رقم ماهانه شما قیمت ارائه خواهیم کرد.
کلید API خود را دریافت کنید
کلیدها برای هر پروژه صادر میشوند. توضیح دهید چه چیزی میسازید و ما ظرف 24 ساعت پاسخ خواهیم داد.