APIs do AI Detector e documentação do servidor MCP

Acesso

Autenticação

A API REST e os clientes MCP locais usam chaves de API em cabeçalhos diferentes. Os conectores MCP hospedados descobrem o OAuth e abrem um fluxo de autorização no navegador.

Segurança de uso

Repita uma solicitação sem pagar duas vezes

Novas integrações devem enviar um Idempotency-Key exclusivo para cada solicitação REST lógica e manter esse valor até que a solicitação seja bem-sucedida ou você a abandone. Se uma conexão cair, tente novamente exatamente o mesmo endpoint, texto, versão ou modelo e chave. Uma repetição exata retorna a resposta armazenada sem executar o provedor ou deduzir as palavras novamente.

Enquanto o primeiro chamador ainda mantém a reserva de processamento, uma tentativa simultânea de repetir exatamente a mesma operação retorna HTTP 409 com Retry-After. Após a conclusão, a resposta exata pode ser recuperada por 24 horas. Quando esse corpo privado expira, a mesma chave retorna HTTP 410. O registro permanente da operação ainda impede uma segunda cobrança.

Endpoint REST

API do detector de IA

Analise o texto fornecido em busca de padrões associados à escrita de IA. Os resultados são sinais de revisão probabilística, não prova de autoria.

Corpo da solicitação

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

Resposta

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

Leia a visão geral da API do detector de IA

Endpoint REST

API do Humanizador de IA

Reescreva o texto fornecido com um modelo humanizador selecionado. O resultado é editável e deve ser revisado quanto ao significado, fatos, nomes, links, tom e terminologia necessária.

Corpo da solicitação

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

Resposta

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

Leia a visão geral da API do Humanizador de IA

Endpoint REST

API do detector de plágio

Procure sobreposições por frase e retorne o contexto da fonte quando houver correspondência. Cada correspondência exige revisão humana, pois citações, permissões e formulações padronizadas afetam seu significado.

Corpo da solicitação

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

Resposta

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

Leia a visão geral da API do Detector de plágio

Streamable HTTP

MCP remoto

Um servidor remoto oferece exatamente duas ferramentas: detect_ai_text e humanize_text. A verificação de plágio está disponível pela API REST, não pelo MCP.

Conectores hospedados

Adicione somente a URL MCP em um conector hospedado. O cliente descobre o OAuth, abre o login e o consentimento no navegador e armazena os próprios tokens. Não acrescente uma chave de API nem outra credencial à 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

Tratamento de falhas

Erros

Verifique o status HTTP e o corpo da resposta. As cargas de erro ainda não foram normalizadas em um esquema universal.

Cotas e limites

Uso e limites

O uso é cobrado a partir da contagem de palavras de entrada separadas por espaços em branco. Os saldos de detector, humanizador e plágio são específicos de cada recurso, inclusive quando a mesma chave acessa mais de um produto.

• Verifique as palavras restantes e os planos ativos no painel API.
• O MCP usa o mesmo saldo do detector ou do humanizador que a API REST correspondente.
• A API REST e o MCP têm um limite padrão de 160.000 caracteres por texto. O MCP também limita o corpo da requisição de transporte a 1 MiB. Divida documentos muito grandes em seções que preservem o sentido.