AI Humanizer API
Гуманизируйте AI-текст в своем продукте одним вызовом REST. AI humanizer API открывает вашему 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. Передайте значение языка, и запрос будет направлен на мультиязычный путь, так что неанглоязычная страница продукта использует ту же конечную точку без второй интеграции.
Регистр и сила — параметры
Пять режимов письма охватывают 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 документов и повторно протестированный по мере обновления моделей обнаружения. Показатели низкого AI-скоринга по детекторам:
Показатели, измеренные поставщиком и опубликованные вместе с их корпусом. Ни один 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-ключ
Ключи выдаются для каждого проекта. Опишите, что вы создаёте, и мы ответим в течение 24 часов.