API REST / reescrita de texto

API do Humanizador de IA para reescritas naturais e editáveis

Envie um rascunho, escolha um modelo humanizador e receba uma nova versão dentro do seu próprio fluxo de trabalho. A resposta permanece fácil de editar, comparar e aprovar antes de se tornar pública.

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

Solicitações POST para /api/humanize/

Autenticação por X-API-Key

Idempotency-Key definido pelo cliente para tentativas recuperáveis

Quatro modelos compatíveis

Uso de palavras em todas as respostas

Uma etapa de reescrita que você controla

Mantenha o texto original, a reescrita e a edição final no mesmo fluxo

Uma integração útil do humanizador não esconde o que mudou. Armazene o original, solicite uma reescrita e dê ao editor um local claro para comparar as duas versões antes de aprovar o resultado.

Entrada JSON simples

Envie o rascunho e o nome de um modelo compatível. A resposta retorna texto simples, o modelo usado e a quantidade de palavras processadas.

A escolha do modelo permanece explícita

Selecione cognia, lexi, cognia_v2 ou huma_v2 com base no comportamento que sua equipe testou para seu próprio conteúdo.

Editável por design

Coloque o texto retornado de volta em um editor, fila de revisão ou sistema de conteúdo em vez de tratá-lo como um artefato finalizado.

Contrato da solicitação

Envie o rascunho e informe o modelo

O endpoint REST exige os dois campos. Mantenha a seleção do modelo na configuração para testá-la e alterá-la sem reescrever a integração.

Campo	Tipo	Obrigatório	O que faz
text	string	Sim	O texto fornecido que você deseja que o serviço reescreva.
model	string	Sim	Um de cognia, lexi, cognia_v2 ou huma_v2.

Três campos facilitam o rastreamento do resultado

Use humanized_text como resultado editável. Registre model_used e words_processed ao lado dele para que as equipes de suporte, faturamento e conteúdo possam entender como a solicitação foi executada.

Exemplo de resposta

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

Fluxo de integração

Trate a humanização como uma etapa de edição

O fluxo de trabalho mais forte mantém o original visível e solicita que uma pessoa aprove a nova versão.

1
Proteja a chave de API
Armazene a chave em seu servidor ou em um gerenciador de segredos. Não a coloque no código público do navegador nem em um documento compartilhado.
2
Envie o texto com um modelo testado
Escolha um modelo compatível, salve um Idempotency-Key exclusivo antes do envio e reutilize essa chave apenas ao repetir exatamente a mesma operação.
3
Revise e aprove
Verifique o texto reescrito quanto à precisão, significado, tom e terminologia necessária antes de salvá-lo ou publicá-lo.

Aplicações indicadas

Uma boa opção para produtos que já têm um editor

A humanização é mais útil quando o rascunho já passa por revisão. A API acrescenta uma opção de reescrita sem substituir quem responde pelo texto final.

Uma reescrita pode mudar o significado

Nomes, citações, figuras, linguagem jurídica e termos técnicos merecem uma verificação cuidadosa. Mantenha esses detalhes visíveis para o revisor.

Gerenciamento de conteúdo

Ofereça uma ação de reescrita dentro de um CMS e retorne o resultado ao mesmo rascunho para comparação e aprovação.

Operações de suporte

Revise o material de origem aprovado em um texto de ajuda mais claro e, em seguida, envie-o por meio da revisão normal de fatos e políticas.

Filas editoriais

Adicione um candidato a reescrita ao lado do original para que um editor possa manter, combinar ou rejeitar alterações individuais.

Ferramentas de escrita privadas

Chame o serviço de um backend confiável e exponha apenas o texto retornado que seu usuário conectado precisa.

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 Humanizador de IA usa?+

Envie uma solicitação POST para https://api.detecting-ai.com/api/humanize/. Use JSON, passe a chave em X-API-Key e salve um Idempotency-Key estável para cada operação lógica, assim você poderá repetir a solicitação com segurança.

Quais modelos do humanizador estão disponíveis?+

Os valores de modelo aceitos são cognia, lexi, cognia_v2 e huma_v2. A API REST exige o campo model em todas as solicitações.

O que contém a resposta?+

Uma resposta bem-sucedida contém humanized_text, words_processed e model_used. O texto reescrito permanece editável em seu produto.

O resultado da API deve ser publicado sem revisão?+

Não. Revise o resultado em busca de significado, fatos, tom, nomes, links e qualquer linguagem que deva permanecer exata. Uma reescrita pode melhorar o fluxo enquanto ainda precisa de um editor.

Como é contado o uso do humanizador?+

O uso se baseia na quantidade de palavras de entrada e é descontado do saldo do humanizador vinculado à assinatura da API. As respostas bem-sucedidas informam words_processed.

Prepare a primeira solicitação

Teste a reescrita em um texto que você conhece bem

Comece com um modelo, compare o resultado com o texto original e decida quais verificações seus editores precisam fazer antes de lançar o recurso.

Abrir documentação da API Comparar preços