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. Передайте значение языка, и запрос будет направлен на мультиязычный путь, так что неанглоязычная страница продукта использует ту же конечную точку без второй интеграции.
Регистр и сила — параметры
Пять режимов письма охватывают академический, корпоративный, творческий, блоговый/SEO и общий регистры. Значение intensityScalar задает, насколько переработка отличается от исходного текста, и принимает одно из значений 0, 0.25, 0.5, 0.75, 1 или 1.25, от Слабый через значение по умолчанию Сбалансированный на 0.5 и Агрессивный на 1 до ULTRA на 1.25.
Один POST на документ
Здесь нет очереди задач для опроса и нет webhook для регистрации. Вызов humanize удерживает соединение, пока модель не вернет ответ, и отвечает переписанным текстом, так что одна заявка завершает работу.
Повторы не списываются дважды
Отправьте requestId — и результат будет кэширован относительно него примерно на десять минут. Повтор того же идентификатора в этом окне воспроизводит сохраненный ответ вместо повторного запуска модели, а любой запрос, который движок не смог завершить, автоматически возвращает свои слова на ваш баланс.
ULTRANEW!
ULTRA: Максимальное снижение AI-оценки через API
Новая шестая настройка интенсивности работает на том же endpoint. Установите intensityScalar в 1.25 для ULTRA, максимальной переработки гуманизатора, со скоростью снижения оценки GPTZero на 89%.
Снижение AI-оценки, семантическая точность и грамматика
- Снижение AI-оценки (GPTZero, %)
- Семантическая верность (поддержка NLI × 100)
- Грамматика (LanguageTool отмечает на 1,000 слов)
Один параметр
Установите intensityScalar в 1.25 в уже отправляемом вами запросе. Конечная точка, ключ Bearer и JSON-ответ остаются без изменений.
Максимальная переработка
ULTRA переписывает большую часть каждого абзаца по сравнению с любым другим режимом, обеспечивая наибольшее снижение AI-оценки, но ценой немного более низкой читаемости и грамматики. Перед отправкой пересмотрите результат.
Только английский текст
ULTRA работает только с английским текстом. Остальные пять настроек охватывают все языки, которые поддерживает API.
Оплата за каждое входное слово
Запрос ULTRA тарифицируется по каждому входному слову, как и любой другой режим, а если движок не сможет завершить запрос, его слова автоматически вернутся на ваш баланс.
Справка по конечной точке
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 или 1.25. Насколько переписывание отходит от исходного текста, от Слабый через Сбалансированный и Агрессивный до ULTRA. ULTRA (1.25) работает только с английским текстом. |
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Время работы движка на переписывание и путь, который его обслужил.keptLinesЗаголовки, списки, таблицы, уравнения и ссылки, возвращённые точно в исходном виде. Поле есть только тогда, когда в тексте есть такие строки.Ошибки и повторные попытки
Каждая ошибка возвращает JSON со стабильным error.code и понятным сообщением. Правило, на которое стоит ориентироваться при проектировании: списание происходит только за доставленное переписывание, а повторная попытка с тем же requestId всегда безопасна.
UNAUTHORIZEDОтсутствует API key или он не распознан. Проверьте заголовок Authorization: Bearer.INSUFFICIENT_BALANCEНа ключе недостаточно кредитов слов. В ответе указан доступный баланс.REQUEST_IN_PROGRESSЗапрос с этим requestId всё ещё обрабатывается. Дождитесь его, а не запускайте параллельно.TOO_LONG / VALIDATION_FAILEDВходные данные превышают лимит в 1,000 слов или параметр задан неверно. В ответе перечислены точные проблемы.ENGINE_ERRORДвижок не смог завершить работу или превысил время ожидания. Слова уже возвращены на ваш баланс; повторите с тем же requestId.INSUFFICIENT_PROSEВ тексте 50 слов основного текста или меньше рядом с заголовками, списками, таблицами, уравнениями или ссылками, поэтому очеловечивать почти нечего. Ничего не списывается; добавьте абзацы и повторите запрос.Что команды создают на основе 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 часов.