AI Humanizer API
Гуманізуйте AI-текст у власному продукті одним REST-запитом. API AI humanizer відкриває вашому backend механізм, що забезпечує роботу 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" }}Що таке API AI humanizer?
API AI humanizer, це REST-ендпоїнт, який переписує згенерований машиною текст у природну, схожу на людську прозу всередині іншого продукту. Замість того щоб вставляти текст у вебзастосунок, ваш бекенд надсилає його як JSON і отримує переписану версію у відповіді, тож humanization стає функцією вашого власного програмного забезпечення: кнопкою в редакторі, етапом у конвеєрі документів або пакетним завданням над бібліотекою контенту.
API humanizer TextPulse надає той самий механізм, що працює в панелі керування TextPulse. Він одночасно працює з понад 20 лінгвістичними сигналами, змінюючи довжину й структуру речень і замінюючи лексику, яку мовні моделі надмірно відбирають, тоді як внутрішньотекстові цитати, бібліографічні записи, статистика та зафіксована термінологія проходять дослівно. На академічному корпусі з 2,000 документів вихід humanized пройшов Turnitin AI у 92.33% випадків, Originality.ai у 89.12% і GPTZero у 87.91%. Саме така поведінка академічного рівня відрізняє його від звичайних ендпоїнтів перефразування: текст, який отримують ваші користувачі, придатний до публікації, а не просто інший.
Що API AI humanizer робить за вас
Маршрутизація мов, контроль регістру, облік і безпека повторних спроб входять до кінцевої точки, тож ваша інтеграція залишається однією функцією.
Один маршрут охоплює 60+ мов
English працює на доопрацьованому механізмі humanizer. Передайте значення мови, і запит буде спрямовано до багатомовного шляху, тож неангломовна сторінка продукту звертається до тієї самої кінцевої точки без другої інтеграції.
Регістр і сила є параметрами
П’ять режимів письма охоплюють академічний, корпоративний, креативний, блоговий/SEO та загальний регістри. Значення intensityScalar визначає, наскільки переписаний текст відрізняється від джерела, і може дорівнювати 0, 0.25, 0.5, 0.75 або 1, від Mild через Balanced за замовчуванням на 0.5 до Aggressive.
Один POST на документ
Немає черги завдань, яку потрібно опитувати, і немає webhook, який потрібно реєструвати. Виклик humanize утримує з’єднання, доки модель не поверне відповідь, і відповідає переписаним текстом, тож одну задачу виконує один запит.
Повторні спроби не списують двічі
Надішліть requestId, і результат буде кешовано приблизно на десять хвилин. Повтор того самого ідентифікатора в межах цього вікна відтворює збережену відповідь замість повторного запуску моделі, а будь-який запит, який механізм не завершує, автоматично повертає його слова на ваш баланс.
Довідка з кінцевих точок
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. Наскільки далеко переписування відходить від джерела, від Mild через Balanced до Aggressive. |
language | string | Необов'язковий | Спрямовує неанглійський текст на багатомовний шлях. Не вказуйте його або надсилайте англійський текст для точно налаштованого англійського механізму. |
englishVariant | string | Необов'язковий | Американський або британський. Утримує правопис і лексику на одному боці Атлантики. |
freezeTerms | string[] | Необов'язковий | До 10 термінів або фраз, які проходять через переписування дослівно: назви конструкцій, інструменти, назви продуктів. |
removeEmDashes | boolean | Необов'язковий | Переписує конструкції з em dash у звичайну пунктуацію. |
requestId | string | Рекомендовано | Ваш токен ідемпотентності. Повторення його протягом приблизно десяти хвилин відтворює збережену відповідь замість повторного списання. |
Поля відповіді
outputTextПереписаний текст.metrics.inputWords / outputWordsОтримані слова і повернуті слова. Переписування часто виходять трохи довшими за джерело.metrics.wordsChargedВартість виклику. Завжди дорівнює кількості вхідних слів, ніколи не кількості вихідних.metrics.balanceRemainingЗалишок словесних кредитів на ключі після цього виклику, щоб можна було вести облік без другого запиту.metrics.modelLatencyMs / routeЧас роботи механізму для переписування і шлях, який його обслуговував.Помилки та повторні спроби
Кожна помилка повертає JSON зі стабільним error.code і зрозумілим для людини повідомленням. Правило, на яке варто орієнтуватися під час проєктування: з вас стягується плата лише за доставлене переписування, а повторна спроба з тим самим requestId завжди безпечна.
UNAUTHORIZEDВідсутній або нерозпізнаний API key. Перевірте заголовок Authorization: Bearer.INSUFFICIENT_BALANCEНедостатньо словесних кредитів на ключі. Відповідь містить доступний баланс.REQUEST_IN_PROGRESSЗапит із цим requestId ще обробляється. Зачекайте на нього, а не запускайте паралельний.TOO_LONG / VALIDATION_FAILEDВхідні дані перевищують ліміт у 1,000 слів або параметр має неправильний формат. Відповідь перелічує точні проблеми.ENGINE_ERRORМеханізм не спрацював або перевищив час очікування. Слова вже повернено на ваш баланс, повторіть спробу з тим самим requestId.Рушій, що лежить в основі endpoint
Кожен виклик запускає опублікований рушій TextPulse, виміряний на академічному корпусі з 2,000 документів і повторно перевірений у міру оновлення моделей виявлення. Показники проходження за детектором:
Показники, виміряні постачальником і опубліковані разом із його корпусом. Жоден humanizer не може обіцяти результат детектора для конкретного документа, тому будуйте повідомлення про свій продукт на вимірюванні, а не на гарантії.
Що команди створюють на основі API humanizer
EdTech і платформи для письма
Додайте дію humanize поруч із наявними функціями граматики або перефразування. Academic mode зберігає цитати без змін, тож інструменти для студентів не мають потреби вилучати посилання перед надсиланням тексту.
Інструменти для роботи з документами та вичитування
Проводьте цілі документи через блоки по 1,000 слів і знову збирайте їх. Freeze terms зберігає імена та термінологію незмінними між блоками, а ідемпотентні повторні спроби роблять пакетні конвеєри безпечними для повторного запуску.
Контентні та SEO продукти
Blog/SEO mode переписує чернетки у придатну до публікації прозу, тоді як freeze terms фіксує цільові ключові слова, тож текст зберігає свій пошуковий намір і втрачає машинний ритм.
Партнери white-label
Endpoint працює непомітно всередині вашого продукту: ваш інтерфейс, ваше білінгування, наш рушій. Партнерські умови розраховуються на основі місячного обсягу через форму доступу.
Тарифи API AI humanizer
Кредити передоплачені та списуються за словами. Облік враховує те, що ви надсилаєте, а не те, що повертає механізм, і будь-який виклик, який не створює переписування, повертається на ключ.
Кредити дійсні протягом 12 місяців із моменту придбання та покривають кожну мову, режим письма й англійський варіант, які підтримує endpoint. Для сталого обсягу або white-label-угоди у вашому власному продукті запросіть доступ, і ми надамо ціну відповідно до вашого місячного обсягу.
Питання про API humanizer для AI
Отримати API-ключ
Ключі видаються для кожного проєкту окремо. Опишіть, що ви створюєте, і ми відповімо протягом 24 годин.