انسانساز AI 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 انسانساز هوش مصنوعی چیست؟
API انسانساز هوش مصنوعی یک نقطه پایانی REST است که متن تولیدشده توسط ماشین را از درون یک محصول دیگر به نثری طبیعی و شبیه نوشتار انسان بازنویسی میکند. بهجای چسباندن متن در یک برنامه وب، بکاند شما آن را بهصورت JSON ارسال میکند و نسخه بازنویسیشده را در پاسخ دریافت میکند، بنابراین انسانسازی به یکی از قابلیتهای نرمافزار خود شما تبدیل میشود: دکمهای در یک ویرایشگر، مرحلهای در یک خط لوله سند، یا یک کار دستهای روی یک کتابخانه محتوا.
API انسانساز TextPulse همان موتوری را در اختیار میگذارد که داشبورد TextPulse را اجرا میکند. این سامانه همزمان روی بیش از 20 سیگنال زبانی کار میکند، طول و ساختار جمله را تغییر میدهد و واژگانی را که مدلهای زبانی بیشازحد برمیگزینند جایگزین میکند، در حالی که ارجاعات درونمتنی، مدخلهای مرجع، آمار و اصطلاحات ثابت بهصورت لفظبهلفظ عبور میکنند. در یک پیکره دانشگاهی 2,000 سندی، خروجی انسانسازیشده در 92.33% موارد از Turnitin AI عبور کرد، در 89.12% از Originality.ai و در 87.91% از GPTZero. همین رفتار در سطح دانشگاهی است که آن را از نقطههای پایانی بازنویسی عمومی متمایز میکند: متنی که کاربران شما دریافت میکنند قابل انتشار است، نه صرفاً متفاوت.
API انسانساز AI چه کارهایی را برای شما انجام میدهد
مسیریابی زبان، کنترل register، سنجش و ایمنی در برابر retry بخشی از endpoint هستند، بنابراین یکپارچهسازی شما در قالب یک تابع باقی میماند.
یک مسیر برای بیش از 60 زبان
English روی موتور انسانساز fine-tuned اجرا میشود. یک مقدار language ارسال کنید و درخواست بهجای آن به مسیر چندزبانه هدایت میشود، بنابراین یک صفحه محصول غیرانگلیسی بدون یک یکپارچهسازی دوم به همان endpoint میرسد.
register و شدت بهصورت پارامتر
پنج حالت نوشتاری، registerهای Academic، Corporate، Creative، Blog/SEO و General را پوشش میدهند. مقدار intensityScalar تعیین میکند بازنویسی تا چه اندازه با متن مبدأ متفاوت باشد و یکی از 0، 0.25، 0.5، 0.75 یا 1 را میپذیرد، از Mild تا Balanced پیشفرض در 0.5 و سپس Aggressive.
یک POST برای هر سند
هیچ صف کاری برای poll کردن و هیچ webhookی برای ثبت وجود ندارد. فراخوان humanize اتصال را تا بازگشت model باز نگه میدارد و با متن بازنویسیشده پاسخ میدهد، بنابراین یک درخواست واحد کار را کامل میکند.
retryها دوبار هزینه ندارند
یک requestId ارسال کنید و نتیجه حدود ده دقیقه با آن در cache ذخیره میشود. تکرار همان شناسه در آن بازه، پاسخ ذخیرهشده را بازپخش میکند، نه اینکه model دوباره اجرا شود، و هر درخواستی که engine در تکمیل آن ناکام بماند، واژههایش را بهطور خودکار به balance شما بازمیگرداند.
مرجع 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. میزان فاصله بازنویسی از متن مبدأ، از Mild تا Balanced و Aggressive. |
language | string | اختیاری | متن غیرانگلیسی را به مسیر چندزبانه هدایت میکند. برای موتور انگلیسیِ تنظیمشده، آن را حذف کنید یا متن انگلیسی بفرستید. |
englishVariant | string | اختیاری | آمریکایی یا بریتانیایی. املا و واژگان را به یکی از دو سوی اقیانوس اطلس محدود میکند. |
freezeTerms | string[] | اختیاری | تا 10 اصطلاح یا عبارت که در بازنویسی بهصورت لفظبهلفظ عبور میکنند: نام سازهها، ابزارها، نام محصولات. |
removeEmDashes | boolean | اختیاری | ساختارهای em dash را به نشانهگذاری متعارف بازنویسی میکند. |
requestId | string | توصیهشده | نشانه idempotency شما. تکرار آن در حدود ده دقیقه، بهجای دریافت هزینه دوباره، پاسخ ذخیرهشده را بازپخش میکند. |
فیلدهای پاسخ
outputTextمتن انسانسازیشده.metrics.inputWords / outputWordsواژههای دریافتشده و واژههای بازگرداندهشده. بازنویسیها اغلب اندکی طولانیتر از متن مبدأ هستند.metrics.wordsChargedهزینه این فراخوانی. همیشه برابر با تعداد ورودی است، نه تعداد خروجی.metrics.balanceRemainingاعتبار واژه باقیمانده روی کلید پس از این فراخوانی، تا بتوانید بدون درخواست دوم، مصرف را اندازهگیری کنید.metrics.modelLatencyMs / routeزمان موتور برای بازنویسی و مسیری که آن را ارائه کرده است.خطاها و تلاشِ مجدد
هر خطا JSON را با یک error.code پایدار و یک پیام قابلفهم برای انسان برمیگرداند. قاعدهای که باید بر اساس آن طراحی کنید این است: شما فقط برای بازنویسیای هزینه میپردازید که تحویل شده باشد، و تلاشِ مجدد با همان requestId همیشه ایمن است.
UNAUTHORIZEDکلید API موجود نیست یا شناسایی نشده است. هدر Authorization: Bearer را بررسی کنید.INSUFFICIENT_BALANCEاعتبار واژه کافی روی کلید وجود ندارد. پاسخ شامل موجودی در دسترس است.REQUEST_IN_PROGRESSدرخواست با این requestId هنوز در حال پردازش است. بهجای رقابت با آن، منتظر بمانید.TOO_LONG / VALIDATION_FAILEDورودی از سقف 1,000 واژه فراتر میرود یا یکی از پارامترها نادرست قالببندی شده است. پاسخ، مسائل دقیق را فهرست میکند.ENGINE_ERRORموتور با خطا مواجه شد یا زمان آن به پایان رسید. واژهها از پیش به موجودی شما بازگردانده شدهاند، با همان requestId دوباره تلاش کنید.موتور پشت این endpoint
هر فراخوانی، موتور منتشرشده TextPulse را اجرا میکند، که بر روی یک پیکره دانشگاهی 2,000 سندی اندازهگیری شده و با بهروزرسانی مدلهای تشخیص، دوباره اجرا میشود. نرخهای عبور به تفکیک detector:
اعداد اندازهگیریشده توسط vendor، که همراه با پیکره آنها منتشر شدهاند. هیچ humanizerی نمیتواند نتیجه یک detector را برای یک سند مشخص تضمین کند، بنابراین پیامرسانی محصول خود را بر پایه اندازهگیری بنا کنید، نه بر پایه تضمین.
تیمها با 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
اعتبارها پیشپرداخت میشوند و بر پایه واژه مصرف میشوند. صورتحساب بر اساس آنچه ارسال میکنید محاسبه میشود، نه آنچه engine بازمیگرداند، و هر فراخوانی که در تولید بازنویسی ناکام بماند، به کلید بازپرداخت میشود.
اعتبارها از زمان خرید به مدت 12 ماه معتبر هستند و همه زبانها، حالتهای نوشتن و گونههای انگلیسی پشتیبانیشده توسط endpoint را پوشش میدهند. برای حجم پایدار یا یک arrangement با white-label درون محصول خودتان، دسترسی را درخواست کنید و ما بر اساس رقم ماهانه شما قیمت ارائه خواهیم کرد.
پرسشهای API humanizer هوش مصنوعی
کلید API خود را دریافت کنید
کلیدها برای هر پروژه صادر میشوند. توضیح دهید چه چیزی میسازید و ما ظرف 24 ساعت پاسخ خواهیم داد.