REST API / переработка текста

API гуманизатора ИИ-текста для естественного редактируемого текста

Отправьте черновик, выберите модель гуманизатора и получите новую версию в своем рабочем процессе. Результат можно отредактировать, сравнить с оригиналом и утвердить до публикации.

Создать API-ключ Прочтите документацию

Используйте ключ из среды частного сервера.

cURL запрос

curl --request POST \
  --url https://api.detecting-ai.com/api/humanize/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: humanizer-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to rewrite.",
    "model": "cognia"
  }'

POST-запросы к /api/humanize/

X-API-Key аутентификация

Idempotency-Key от клиента для безопасных повторных попыток

Четыре поддерживаемые модели

Число обработанных слов в каждом ответе

Контролируемый этап переработки

Храните оригинал, новую версию и финальную правку в одном процессе

Хорошая интеграция гуманизатора не скрывает изменений. Сохраните оригинал, запросите новую версию и дайте редактору возможность сравнить оба текста перед утверждением результата.

Простой ввод JSON

Отправьте черновик и одно название поддерживаемой модели. Ответ возвращает обычный текст, а также модель и количество обработанных слов.

Выбор модели остается явным

Выберите cognia, lexi, cognia_v2 или huma_v2 в зависимости от того, какая модель лучше показала себя на материалах вашей команды.

Результат можно редактировать

Верните полученный текст в редактор, очередь правок или систему управления контентом, а не воспринимайте его как готовую публикацию.

Контракт запроса

Отправьте черновик и назовите модель

Оба поля обязательны для REST-эндпоинта. Храните выбор модели в конфигурации, чтобы тестировать и менять его без переделки интеграции.

Поле	Тип	Обязательно	Что он делает
text	string	Да	Текст, который нужно переработать.
model	string	Да	Один из cognia, lexi, cognia_v2 или huma_v2.

Три поля позволяют легко отслеживать результат

Используйте humanized_text как редактируемый результат. Сохраняйте рядом model_used и words_processed, чтобы команды поддержки, биллинга и контента могли понять, как был выполнен запрос.

Пример ответа

{
  "humanized_text": "The rewritten text is returned here.",
  "words_processed": 8,
  "model_used": "cognia"
}

Процесс интеграции

Относитесь к гуманизации как к этапу редактирования

Надёжный процесс оставляет исходный текст доступным для сравнения и требует утверждения новой версии человеком.

1
Защитите API-ключ
Храните ключ на своем сервере или в секретном менеджере. Не размещайте его в общедоступном коде браузера или в общем документе.
2
Отправьте текст с протестированной моделью
Выберите одну поддерживаемую модель, сохраните уникальный Idempotency-Key перед отправкой и повторно используйте этот ключ только для точной повторной попытки.
3
Проверьте и утвердите
Проверьте переписанный текст на точность, смысл, тон и необходимую терминологию, прежде чем сохранять или публиковать его.

Подходящие применения

Подходит продуктам, в которых уже есть редактор

Гуманизация особенно полезна, когда черновик уже проходит редакционную проверку. API добавляет возможность переработки текста, но окончательное решение остаётся за ответственным редактором.

Переписывание может изменить смысл

Имена, цитаты, цифры, юридические формулировки и технические термины требуют тщательной проверки. Оставляйте эти детали доступными для редактора.

Управление контентом

Предложите действие перезаписи внутри CMS и верните результат в тот же черновик для сравнения и утверждения.

Операции поддержки

Переработайте утвержденный исходный материал в более понятный справочный текст, а затем отправьте его через обычную проверку фактов и политики.

Редакционные очереди

Покажите новую версию рядом с оригиналом, чтобы редактор мог принять, объединить или отклонить отдельные изменения.

Частные письменные инструменты

Вызовите службу из доверенной серверной части и предоставляйте только возвращаемый текст, который нужен вошедшему пользователю.

Вопросы об API

Практические ответы перед запуском

Начните с запроса на стороне сервера, запишите форму ответа, а затем добавьте результат в существующий поток проверки.

Какой эндпоинт использует API гуманизатора ИИ-текста?+

Отправьте POST-запрос на https://api.detecting-ai.com/api/humanize/. Используйте JSON, передайте ключ в X-API-Key и сохраняйте стабильный Idempotency-Key для каждой логической операции, чтобы безопасно повторять запрос.

Какие модели гуманизаторов доступны?+

Поддерживаемые значения модели: cognia, lexi, cognia_v2 и huma_v2. REST API ожидает поле модели при каждом запросе.

Что содержит ответ?+

Успешный ответ содержит humanized_text, words_processed и model_used. Переписанный текст остается доступным для редактирования в вашем продукте.

Следует ли публиковать результаты API без проверки?+

Нет. Проверьте смысл, факты, тон, имена, ссылки и все формулировки, которые должны остаться точными. Переработка может сделать текст более естественным, но результат всё равно должен проверить редактор.

Как учитывается использование гуманизатора?+

Расход зависит от количества входных слов и списывается из лимита гуманизатора в подписке API. Успешный ответ содержит поле words_processed.

Создайте первый запрос

Проверьте переписывание текста, который вы хорошо знаете.

Начните с одной модели, сравните результат с исходным текстом и определите, какие проверки нужны редакторам до запуска функции.

Открыть документацию API Сравните цены