AI Humanizer API
Humanize texto de IA no seu produto com uma única chamada REST. A API humanizadora expõe ao seu backend o mecanismo que alimenta a TextPulse: JSON entra, prosa reescrita sai, em mais de 60 idiomas.
Fazendo sua primeira solicitação
Autentique com um cabeçalho Authorization: Bearer e envie seu texto. A versão reescrita retorna como outputText junto com os dados de medição dessa chamada.
curl https://textpulse.ai/api/v1/humanize \ -H "Authorization: Bearer tp_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Our analysis indicates the intervention produced gains...", "writingMode": "Academic", "intensityScalar": 0.5 }'{ "outputText": "Our analysis points to measurable gains from the...", "metrics": { "inputWords": 128, "outputWords": 134, "wordsCharged": 128, "balanceRemaining": 99872, "modelLatencyMs": 4310, "route": "v1/humanize" }}O que a API humanizadora de IA faz por você
Roteamento de idioma, controle de registro, medição e segurança contra repetição fazem parte do endpoint, então sua integração permanece uma única função.
Uma rota cobre mais de 60 idiomas
O inglês usa o mecanismo refinado de humanização. Passe um valor de idioma e a solicitação será roteada para o caminho multilíngue, de modo que uma página de produto em outro idioma chegue ao mesmo endpoint sem uma segunda integração.
Registro e intensidade são parâmetros
Cinco modos de escrita cobrem os registros Acadêmico, Corporativo, Criativo, Blog/SEO e Geral. O valor intensityScalar define o quanto a reescrita difere da fonte e assume um de 0, 0.25, 0.5, 0.75 ou 1, indo de Mild, passando pelo padrão Balanced em 0.5, até Aggressive.
Um POST por documento
Não há fila de tarefas para consultar nem webhook para registrar. A chamada humanize mantém a conexão até o modelo retornar e responde com o texto reescrito, então uma única solicitação conclui o trabalho.
Repetições não são cobradas duas vezes
Envie um requestId e o resultado é armazenado em cache contra ele por cerca de dez minutos. Uma repetição do mesmo identificador dentro dessa janela reproduz a resposta armazenada em vez de executar o modelo novamente, e qualquer solicitação que o mecanismo não consiga concluir devolve suas palavras ao seu saldo automaticamente.
Referência do endpoint
Authorization: Bearer. As chaves começam com tp_live_ e são emitidas por projeto./api/v1/humanize/api/v1/balanceUma única chamada humanize aceita até 1,000 palavras dentro de um limite de 10,000 caracteres, e cada chave pode emitir 60 solicitações por minuto. Documentos mais longos são enviados como uma sequência de chamadas.
Parâmetros da solicitação
Apenas text é obrigatório. Todo o restante tem um padrão sensato, então a integração mínima é um único campo.
| Parâmetro | Type | Presença | Observações |
|---|---|---|---|
text | string | Obrigatório | O texto a ser humanizado. Até 1,000 palavras dentro de um limite de 10,000 caracteres por solicitação. |
writingMode | string | Padrão: Acadêmico | Uma entre Academic, Corporate, Creative, Blog/SEO ou General. Define o registro que a reescrita mantém. |
intensityScalar | number | Padrão: 0.5 | Um entre 0, 0.25, 0.5, 0.75 ou 1. Até que ponto a reescrita se afasta do texto de origem, de Mild a Balanced até Aggressive. |
language | string | Opcional | Encaminha texto em outro idioma para o caminho multilíngue. Omitir, ou enviar inglês, para o mecanismo em inglês ajustado. |
englishVariant | string | Opcional | Americano ou britânico. Mantém a ortografia e o vocabulário de um lado do Atlântico. |
freezeTerms | string[] | Opcional | Até 10 termos ou expressões preservados literalmente ao longo da reescrita: nomes de construções, instrumentos, nomes de produtos. |
removeEmDashes | boolean | Opcional | Reescreve construções com travessão em pontuação convencional. |
requestId | string | Recomendado | Seu token de idempotência. Repeti-lo em cerca de dez minutos reproduz a resposta armazenada em vez de cobrar novamente. |
Campos da resposta
outputTextO texto humanizado.metrics.inputWords / outputWordsPalavras recebidas e palavras retornadas. As reescritas frequentemente ficam um pouco mais longas que o texto de origem.metrics.wordsChargedO custo da chamada. Sempre é igual à contagem de entrada, nunca à contagem de saída.metrics.balanceRemainingCréditos de palavras restantes na chave após esta chamada, para que você possa medir sem uma segunda solicitação.metrics.modelLatencyMs / routeTempo do mecanismo para a reescrita e o caminho que a atendeu.Erros e repetição
Todo erro retorna JSON com um error.code estável e uma mensagem legível. A regra que vale a pena considerar no projeto é, você só é cobrado por uma reescrita que foi entregue, e repetir com o mesmo requestId é sempre seguro.
UNAUTHORIZEDChave de API ausente ou não reconhecida. Verifique o cabeçalho Authorization: Bearer.INSUFFICIENT_BALANCECréditos de palavras insuficientes na chave. A resposta inclui o saldo disponível.REQUEST_IN_PROGRESSUma solicitação com este requestId ainda está sendo processada. Aguarde em vez de disputá-la.TOO_LONG / VALIDATION_FAILEDA entrada ultrapassa o limite de 1,000 palavras ou um parâmetro está malformado. A resposta lista os problemas exatos.ENGINE_ERRORO mecanismo falhou ou expirou por tempo. As palavras já foram devolvidas ao seu saldo; tente novamente com o mesmo requestId.O mecanismo por trás do endpoint
Cada chamada executa o mecanismo publicado da TextPulse, medido em um corpus acadêmico de 2.000 documentos e executado novamente à medida que os modelos de detecção são atualizados. Taxas de baixa pontuação por detector:
Números medidos pelo fornecedor, publicados com o respectivo corpus. Nenhum humanizador pode prometer um resultado de detector em um documento específico, portanto, construa a mensagem do seu produto com base na medição, nunca em uma garantia.
O que as equipes constroem com a API de humanização
EdTech e plataformas de escrita
Adicione uma ação de humanização ao lado dos seus recursos existentes de gramática ou paráfrase. O modo Acadêmico mantém as citações intactas, de modo que ferramentas voltadas a estudantes não precisam remover referências antes de enviar o texto.
Ferramentas de documentos e revisão
Encaminhe documentos inteiros em blocos de 1.000 palavras e recompile. Os termos fixos mantêm nomes e terminologia estáveis entre os blocos, e as tentativas idempotentes tornam os pipelines em lote seguros para executar novamente.
Produtos de conteúdo e SEO
O modo Blog/SEO reescreve rascunhos em prosa pronta para publicação, enquanto os termos fixos bloqueiam as palavras-chave-alvo, de modo que o texto preserva sua intenção de busca e perde o ritmo mecânico.
Parceiros white-label
O endpoint opera de forma invisível dentro do seu produto: sua interface, sua cobrança, nosso mecanismo. As condições de parceria são cotadas com base no volume mensal por meio do formulário de acesso.
Preços da API humanizadora de IA
Os créditos são pré-pagos e descontados pela quantidade de palavras. A cobrança contabiliza o que você envia, nunca o que o mecanismo retorna, e qualquer chamada que falhe em produzir uma reescrita é creditada de volta na chave.
Os créditos são válidos por 12 meses a partir da compra e cobrem todos os idiomas, modos de escrita e variantes do inglês que o endpoint oferece suporte. Para volume contínuo ou um arranjo white-label dentro do seu próprio produto, solicite acesso e faremos uma cotação com base no seu volume mensal.
Obtenha sua chave de API
As chaves são emitidas por projeto. Descreva o que você está desenvolvendo e responderemos em até 24 horas.