API детектора ИИ и документация MCP

Доступ

Аутентификация

REST-запросы и локальные MCP-клиенты передают пользовательские API-ключи в разных заголовках. Облачные MCP-коннекторы обнаруживают OAuth и запускают авторизацию в браузере.

Безопасность использования

Повторите один запрос, не платя дважды

Новые интеграции должны отправлять уникальный Idempotency-Key для каждого логического REST-запроса и хранить его, пока запрос не завершится успешно или вы не откажетесь от дальнейших попыток. Если соединение оборвалось, повторите запрос с теми же эндпоинтом, текстом, версией или моделью и ключом. Точный повтор вернёт сохранённый ответ без нового обращения к провайдеру и повторного списания слов.

Пока первый запрос ещё выполняется у провайдера, одновременный точный повтор возвращает HTTP 409 с Retry-After. После завершения тот же ответ можно получить повторно в течение 24 часов. Когда закрытое тело ответа удаляется, запрос с тем же ключом возвращает HTTP 410. Постоянная служебная запись по-прежнему предотвращает повторное списание.

REST-эндпоинт

API детектора ИИ

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

Тело запроса

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"
  }'

Ответ

{
  "success": true,
  "data": {
    "details": {
      "chunks": [
        {
          "text": "A sentence from the input.",
          "startChar": 0,
          "endChar": 26,
          "type": "AI",
          "score": 0.87
        }
      ],
      "ai_percentage": 42.5
    },
    "version": "v3",
    "words_processed": 120
  }
}

Прочитать обзор API детектора ИИ

REST-эндпоинт

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

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

Тело запроса

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"
  }'

Ответ

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

Прочитать обзор API гуманизатора ИИ-текста

REST-эндпоинт

API проверки на плагиат

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

Тело запроса

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

Ответ

{
  "result": {
    "results": [
      {
        "sentence": "A sentence from the input.",
        "is_plagiarised": true,
        "web_sentence": "A similar source sentence.",
        "similarity": 91.0,
        "link": "https://example.com/source"
      }
    ],
    "plagiarism_score": 34.2
  },
  "words_processed": 120
}

Прочитать обзор API проверки на плагиат

Streamable HTTP

Удалённый MCP-сервер

Один удалённый сервер предоставляет ровно два инструмента: detect_ai_text и humanize_text. Проверка на плагиат доступна через REST, а не MCP.

Облачные коннекторы

Добавьте в облачный коннектор только URL MCP. Клиент обнаружит OAuth, откроет вход и страницу согласия в браузере, а затем сохранит собственные токены. Не добавляйте API-ключ или другие учётные данные в URL.

Codex

export DETECTING_AI_API_KEY="YOUR_API_KEY"

[mcp_servers.detecting_ai]
url = "https://api.detecting-ai.com/api/mcp"
bearer_token_env_var = "DETECTING_AI_API_KEY"
tool_timeout_sec = 300

Claude Code

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer YOUR_API_KEY" \
  detecting-ai https://api.detecting-ai.com/api/mcp

Обработка сбоев

Ошибки

Проверьте статус HTTP и тело ответа. Полезные данные ошибок еще не нормализованы в одну универсальную схему.

Квоты и границы

Использование и ограничения

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

• Проверьте оставшиеся слова и активные планы на панели управления API.
• MCP расходует тот же лимит детектора или гуманизатора, что и соответствующий REST API.
• REST и MCP по умолчанию имеют ограничение на длину текста в 160 000 символов. MCP также имеет ограничение на тело транспорта 1 MiB. Разделяйте необычно большие документы на значимые разделы.