AI Humanizer API
Humanize AI text in your product with a single REST call. The AI humanizer API exposes the engine behind TextPulse to your backend: JSON goes in, rewritten prose comes back, across more than 60 languages.
Первый запрос
Аутентифицируйтесь с заголовком 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. Передайте значение языка, и запрос будет направлен на мультиязычный путь, так что неанглоязычная страница продукта использует ту же конечную точку без второй интеграции.
Регистр и сила — параметры
Пять режимов письма охватывают Academic, Corporate, Creative, Blog/SEO и General. Значение 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 words при лимите 10,000 characters, и каждый ключ может выполнять 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 | Необязательный | Направляет неанглийский текст по многоязычному пути. Не указывайте его или отправляйте English для тонко настроенного английского движка. |
englishVariant | string | Необязательный | American или British. Ограничивает орфографию и лексику одной стороной Атлантики. |
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 сохраняет цитаты без изменений, поэтому инструментам для студентов не нужно удалять ссылки перед отправкой текста.
Инструменты для работы с документами и вычитки
Проводите целые документы через блоки по 1,000 слов и собирайте их заново. Freeze terms сохраняет имена и терминологию неизменными между блоками, а идемпотентные повторы делают пакетные конвейеры безопасными для повторного запуска.
Контентные и SEO-продукты
Режим Blog/SEO переписывает черновики в текст, пригодный для публикации, а freeze terms фиксирует целевые ключевые слова, чтобы текст сохранял поисковое намерение и терял машинный ритм.
Партнеры white-label
Endpoint работает незаметно внутри вашего продукта: ваш интерфейс, ваша биллинговая система, наш движок. Условия для партнеров рассчитываются по ежемесячному объему через форму доступа.
Тарифы API AI humanizer
Кредиты предоплачены и расходуются по словам. Списание учитывает то, что вы отправляете, а не то, что возвращает движок, и любой вызов, который не создает переписанный текст, возвращается на ключ.
Кредиты действительны 12 месяцев с момента покупки и покрывают каждый язык, режим письма и вариант английского, которые поддерживает endpoint. Для устойчивого объёма или white-label-соглашения внутри вашего собственного продукта запросите доступ, и мы рассчитаем стоимость исходя из вашего ежемесячного объёма.
Вопросы об API humanizer на основе ИИ
Получить API-ключ
Ключи выдаются для каждого проекта. Опишите, что вы создаёте, и мы ответим в течение 24 часов.