API REST / detecção de IA

API do detector de IA para sinais prontos para revisão

Envie texto para um endpoint HTTPS e traga a análise de escrita de IA para seu próprio produto. O Detector v3 retorna dados estruturados que sua equipe pode inspecionar, armazenar e explicar no contexto.

Criar uma chave de API Leia a documentação

Use a chave de um ambiente de servidor privado.

Solicitação 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"
  }'

Solicitações POST para /api/detect/

Autenticação por X-API-Key

Idempotency-Key definido pelo cliente para tentativas recuperáveis

Detector v3 para novas integrações

Solicitação e resposta em JSON

Construído para fluxos de revisão reais

Um contrato de API simples, com espaço para avaliação cuidadosa

A integração permanece simples: seu servidor envia o texto, o detector o analisa e sua interface decide como apresentar o resultado. Essa separação torna o fluxo de trabalho mais fácil de testar e mantém a decisão final com uma pessoa.

Um endpoint focado

Inclua uma string de texto e a versão do detector em uma solicitação JSON. A integração básica não depende de um SDK que precise ser mantido em sincronia.

Saída estruturada

Leia na resposta os detalhes do detector, a versão e a quantidade de palavras processadas, sem extrair dados de uma página da web.

A revisão humana permanece visível

Use o sinal para priorizar trechos e casos. Não transforme a pontuação de um modelo em acusação ou rejeição automática.

Contrato da solicitação

Dois campos são suficientes para começar

Envie texto UTF-8 como JSON e escolha a versão do detector deliberadamente. Novas integrações devem usar v3.

Campo	Tipo	Obrigatório	O que faz
text	string	Sim	O texto que você deseja que o detector analise.
version	string	Sim	Versão do detector. Use v3 para uma nova integração.

Mantenha a resposta completa durante o desenvolvimento

Comece registrando a resposta JSON completa em um ambiente de teste seguro. Assim que o contrato estiver claro, mapeie apenas os campos que seu produto usa e retenha a contagem de palavras processadas para registros de uso.

Exemplo de resposta

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

Fluxo de integração

Da chave de API a um resultado útil

Primeiro, crie a solicitação no servidor. Adicione a interface do produto somente quando o fluxo principal e os casos de falha estiverem claros.

1
Prepare, salve e ative a chave
Prepare uma chave no painel, copie o valor exibido uma única vez para um gerenciador de segredos no servidor, confirme que a chave foi salva e ative-a. O valor completo não volta a ser exibido após a ativação.
2
Envie uma amostra representativa
Envie um texto realista com a versão v3 e salve um Idempotency-Key exclusivo antes da solicitação. Reutilize essa chave apenas ao repetir exatamente a mesma operação.
3
Apresente as evidências com cuidado
Traduza a resposta estruturada em um estado de revisão claro, com espaço para uma pessoa inspecionar o texto e o contexto.

Aplicações indicadas

Útil sempre que o texto já passa por uma fila de revisão

A API funciona melhor como uma entrada para um processo de decisão existente. Deve ajudar as pessoas a decidir onde procurar, e não a tomar a decisão por elas.

A detecção não é prova de autoria

Os modelos podem errar, principalmente com textos curtos, muito editados, traduzidos ou padronizados. Não deixe decisões importantes a cargo de fluxos totalmente automáticos.

Ingestão editorial

Adicione um sinal de autoria aos rascunhos enviados e encaminhe casos incomuns a um editor para uma leitura mais detalhada.

Plataformas educacionais

Mostre um sinal de revisão ao lado do contexto da tarefa, do histórico de alterações, das citações e da política da própria instituição.

Moderação interna

Verifique o texto recebido em um fluxo de trabalho privado sem enviar sua chave de API para o navegador.

Triagem em lote

Processe documentos enfileirados no servidor e revele os casos que merecem uma segunda análise manual.

Perguntas frequentes sobre a API

Respostas práticas antes do lançamento

Comece com uma solicitação do lado do servidor, registre o formato da resposta e adicione o resultado ao fluxo de revisão existente.

Qual endpoint a API do detector de IA usa?+

Envie uma solicitação POST para https://api.detecting-ai.com/api/detect/. O corpo da solicitação usa JSON, a autenticação usa X-API-Key e novas integrações devem salvar um Idempotency-Key estável para cada operação lógica.

Qual versão do detector uma nova integração deve usar?+

Use v3 para novas integrações. A versão é fornecida no corpo da solicitação JSON para que o comportamento seja explícito e fácil de testar.

Posso chamar a API diretamente pelo JavaScript do navegador?+

Não exponha uma chave privada de API no código do navegador. Envie as solicitações pelo seu servidor, por uma função de edge ou por outro ambiente confiável e retorne apenas o resultado necessário para a interface.

Uma pontuação de IA prova quem escreveu o texto?+

Não. A detecção de IA é um sinal probabilístico. Use-o para direcionar a revisão a um texto específico e depois considere os rascunhos, as fontes, o histórico de escrita e o contexto.

Onde posso verificar o uso da API e o saldo de palavras?+

O painel da API mostra o saldo vinculado à sua assinatura. Cada solicitação bem-sucedida ao detector informa quantas palavras de entrada foram processadas.

Prepare a primeira solicitação

Faça uma solicitação de teste antes de projetar o fluxo de trabalho

Use o Detector v3, mantenha a chave em seu servidor e inspecione a resposta JSON completa com um texto semelhante à sua entrada real.

Abrir documentação da API Comparar preços