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 робить за вас
Маршрутизація мов, контроль регістру, облік і безпека повторних спроб входять до кінцевої точки, тож ваша інтеграція залишається однією функцією.
Один маршрут охоплює 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 документів і повторно перевірений у міру оновлення моделей виявлення. Показники низького AI-рейтингу за детектором:
Показники, виміряні постачальником, опубліковані разом із їхнім корпусом. Жоден 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-ключ
Ключі видаються для кожного проєкту окремо. Опишіть, що ви створюєте, і ми відповімо протягом 24 годин.