REST API / обнаружение искусственного интеллекта

API детектора ИИ для сигналов, готовых к проверке

Отправьте текст на один HTTPS-эндпоинт и добавьте проверку на ИИ в свой продукт. Detector v3 вернет структурированные данные, которые команда сможет изучить, сохранить и объяснить с учетом контекста.

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

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

cURL запрос

curl --request POST \
  --url https://api.detecting-ai.com/api/detect/ \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: detector-review-001" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "text": "Paste the text you want to analyze.",
    "version": "v3"
  }'

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

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

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

Детектор v3 для новых сборок

JSON запрос и ответ

Для реальных процессов проверки

Небольшой контракт API с возможностью тщательного принятия решений.

Интеграция остается простой: ваш сервер отправляет текст, детектор анализирует его, а ваш интерфейс решает, как представить результат. Такое разделение упрощает тестирование рабочего процесса и позволяет пользователю принять окончательное решение.

Один специализированный эндпоинт

Добавьте строку текста и версию детектора в JSON-запрос. Для базовой интеграции не нужно подключать и поддерживать отдельный SDK.

Структурированный вывод

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

Проверка человеком остаётся частью процесса

Используйте сигнал, чтобы расставить приоритеты отрывков и случаев. Не превращайте одну оценку модели в автоматическое обвинение или отказ.

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

Для начала достаточно двух полей

Отправьте текст UTF-8 как JSON и сознательно выберите версию детектора. В новых интеграциях следует использовать v3.

Поле	Тип	Обязательно	Что он делает
text	string	Да	Текст, который детектор должен проанализировать.
version	string	Да	Версия детектора. Используйте v3 для новой интеграции.

Сохраняйте полный ответ во время разработки

Сначала записывайте полный JSON-ответ в защищённой тестовой среде. Когда контракт станет понятен, сопоставьте только нужные продукту поля и сохраняйте число обработанных слов для учёта расхода.

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

{
  "success": true,
  "data": {
    "details": {
      "result": "Detector analysis is returned here"
    },
    "version": "v3",
    "words_processed": 8
  }
}

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

От API-ключа к полезному результату

Сначала сформируйте запрос на своём сервере. Добавляйте интерфейс только после того, как проверите успешный сценарий и возможные ошибки.

1
Подготовьте, сохраните и активируйте ключ.
Подготовьте ключ на панели управления, скопируйте одноразовое значение в диспетчер секретов на стороне сервера, подтвердите его сохранение и активируйте его. После активации полное значение больше не отображается.
2
Отправьте репрезентативный образец
Отправьте реалистичный текст POST-запросом с версией v3 и заранее сохраните уникальный Idempotency-Key. Используйте его повторно только при точном повторе запроса.
3
Внимательно представляйте доказательства
Преобразуйте структурированный ответ в понятный статус проверки и оставьте возможность человеку изучить текст и контекст.

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

Полезно везде, где текст уже проходит через очередь проверки.

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

Обнаружение не является доказательством авторства

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

Редакция

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

Образовательные платформы

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

Внутренняя модерация

Проверяйте переданный текст в закрытом рабочем процессе, не отправляя API-ключ в браузер.

Пакетная сортировка

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

Вопросы об API

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

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

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

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

Какую версию детектора следует использовать в новой интеграции?+

Используйте v3 для новых интеграций. Версия предоставляется в теле запроса JSON, поэтому поведение является явным и легко тестируемым.

Могу ли я вызвать API непосредственно из JavaScript браузера?+

Не раскрывайте личный API-ключ в коде браузера. Отправляйте запросы со своего сервера, edge-функции или другой доверенной среды и возвращайте только данные, необходимые интерфейсу.

Доказывает ли оценка ИИ, кто написал текст?+

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

Где я могу проверить использование API и оставшиеся слова?+

На панели API отображается лимит, связанный с вашей подпиской. Каждый успешный запрос детектора сообщает количество обработанных входных слов.

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

Прежде чем разрабатывать рабочий процесс, сделайте один тестовый запрос.

Используйте детектор v3, сохраните ключ на своем сервере и проверьте полный ответ JSON с текстом, который похож на ваш реальный ввод.

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