POST /v1/humanize
Um request, uma resposta clara: insira o texto, receba a versão humanizada e os valores de IA. O mesmo Humanizer do navegador – agora no seu código.
O idioma é detetado e mantido automaticamente: português e mais de 40 outros. A faturação é feita com base no número exato de palavras de entrada medidas.
Criar chave de APIVer documentação
Registo gratuito · Faturação por palavras de entrada · Sem período mínimo de fidelização
curl https://api.studytexter.com/v1/humanize \
-H "Authorization: Bearer $STUDYTEXTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "A digitalização coloca as empresas perante..."}'{
"humanized_text": "As empresas enfrentam, devido à digitalização, muitos...",
"ai_detection": {
"original": { "ai_percent": 81.58, "human_mixed_percent": 18.42 },
"humanized": { "ai_percent": 3.83, "human_mixed_percent": 96.17 }
}
}
Valores de IA em cada chamada – Detetores conhecidos de, entre outros:
Fundamentos
A Humanizer API é uma interface REST através da qual textos do ChatGPT, Claude, Gemini ou DeepSeek são revistos programaticamente para que soem mais naturais – como AI Humanizer API em inglês, ou KI-Humanizer-API em alemão. Humanizar texto por API significa aqui: envias um POST com o teu texto para /v1/humanize e recebes a versão humanizada de volta, juntamente com valores de deteção de IA para ambas as versões como valor de medição. Por trás disto, corre a mesma deteção de idioma, a mesma medição de palavras e o mesmo processamento que no Humanizador de IA no navegador – não existe uma variante simplificada para programadores.
Integração
Sem SDK, sem conversa de onboarding, sem indicação de idioma. A REST-API funciona com uma chave, um endpoint e um campo obrigatório no body.
Criar chave
Registe-se, aceda à página de chaves na aplicação, crie uma chave. O segredo completo é exibido apenas uma vez.
Enviar texto
POST para /v1/humanize com Authorization: Bearer e um body JSON que contém apenas text. Não envias uma indicação de idioma – ela é detetada.
Processar resposta
Receberá humanized_text e os valores de IA para o original e o resultado. Em caso de erro, error.retryable decide se uma segunda tentativa é permitida.
curl --request POST 'https://api.studytexter.com/v1/humanize' \
--header "Authorization: Bearer $STUDYTEXTER_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"text":"A digitalização coloca as empresas perante múltiplos desafios, uma vez que os processos existentes têm de ser revistos e reestruturados. A utilização responsável da IA continua a exigir um trabalho de fontes cuidadoso e um discernimento próprio."}'O texto de exemplo completo, o ficheiro OpenAPI e a versão Markdown para agentes estão disponíveis na documentação.
Agentes
Um agente que gera texto precisa do Humanizer como ferramenta – não como um site. Três coisas são decisivas quando já ninguém está a supervisionar.
Registar como Tool
Um endpoint, um campo obrigatório, sem opções. A definição da ferramenta cabe em algumas linhas e pode ser armazenada no LangChain, no SDK da Anthropic, no n8n ou num loop próprio.
Em processos de várias etapas
O agente gera texto com um modelo, passa-o por /v1/humanize e encaminha o resultado. O idioma permanece o do rascunho, sem que o processo precise de o conhecer.
Repetir sem cobrança dupla
Cada erro indica através de error.retryable se uma nova tentativa é segura. Se a ligação for interrompida sem resposta, uma Idempotency-Key desduplica: a mesma chave com o mesmo texto devolve a resposta guardada em vez de uma segunda cobrança.
{
"name": "humanize_text",
"description": "Revisa uma minuta de IA para que soe mais natural. O idioma é detetado e mantido. Números, nomes, fontes e termos técnicos são mantidos.",
"input_schema": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "O texto a ser revisado. De 100 a 30.000 caracteres, no máximo 3.000 palavras."
}
},
"required": ["text"]
}
}Um agente não precisa de mais nada. Não há campo de idioma, tom ou intensidade que ele possa definir incorretamente – e, portanto, nenhum grau de liberdade em que uma execução possa falhar silenciosamente. A descrição completa está adicionalmente disponível como OpenAPI 3.1 e como llms.txt; ambos podem ser apresentados diretamente a um modelo.
Casos de uso
Em todos os lugares onde um modelo escreve o rascunho e, mesmo assim, um ser humano assina como remetente.
Ferramentas de escrita
O teu editor gera um rascunho via LLM e envia-o através da API antes da exibição. Os teus utilizadores veem o resultado, não o passo intermédio.
Pipelines de conteúdo
Os fluxos de redação e publicação anexam a chamada após a geração. O débito provém de 60 tarefas paralelas, não de textos individuais mais longos.
Frameworks de agentes
LangChain, CrewAI, o SDK da Anthropic ou um loop próprio: o endpoint é uma ferramenta entre outras e não necessita de tratamento especial.
SEO e Marketing
Textos de blog, descrições de produtos, newsletters. O que um modelo rascunhou é publicado como texto corrido, sem que ninguém o refine manualmente.
Plataformas académicas
Ambientes de aprendizagem e ferramentas de escrita cujos utilizadores trabalham com fontes. Citações, números de página e termos técnicos são mantidos palavra por palavra – exatamente o ponto em que a maioria dos humanizadores falha.
White-Label e SaaS
Humanizar como uma funcionalidade própria no teu produto, sob o teu nome. A cobrança é feita através da tua conta StudyTexter; os teus utilizadores não veem nada disso.
Diferenças
Não por ser mais rápida que outras, mas por ter menos pontos onde algo pode falhar silenciosamente.
O idioma é detetado, não definido
Não envias um campo `language`. O idioma dominante do texto de entrada é detetado e mantido na resposta – mais de 40 idiomas. Um parâmetro definido incorretamente não pode estragar nada.
Valores de IA para ambas as versões
A resposta contém probabilidades do detetor para o texto original e para o resultado. Podes exibir ou registar no teu produto o que mudou – sem uma segunda ferramenta.
As fontes permanecem palavra por palavra
Citações, números de página, nomes de autores e anos não são reformulados. É por isso que a API pode ser usada em produtos académicos.
Faturação por palavras de entrada
É contado o texto que envias – com segmentação ICU numa cópia normalizada NFC. O comprimento da resposta não altera o preço.
O mesmo motor que no navegador
573,7 milhões de palavras humanizadas e mais de 63.573 utilizadores passam pelo mesmo processamento. O que a API fornece, podes verificar na interface.
Atualizações de modelo incluídas
Melhorias no processamento chegam à API ao mesmo tempo que à interface. Não precisas de alterar nada na tua integração para isso.
Preços
A API não tem tarifas próprias. Utiliza o mesmo saldo que a ferramenta no navegador – subscrição ou compra única, ambos são válidos para ambas as vias.
O GPTZero classifica os nossos textos como mais humanos do que textos reais de estudantes (Ø 84% vs. 80%).
Mais de 573,7 milhões de palavras humanizadasStudent
14,99€por mês
5,00€ / 10.000 palavrasA garantia aplica-se ao scanner de IA GPTZero: se o teu texto humanizado for aí detetado como IA, reembolsamos as palavras consumidas. Basta uma breve mensagem para o suporte.
Iniciar subscriçãoOu compra única
Starter
9,99€pagamento único
12,49€ / 10.000 palavrasStandard
34,99€pagamento único
8,75€ / 10.000 palavrasPower
69,99€pagamento único
7,78€ / 10.000 palavrasAtravés da API pública são utilizadas exclusivamente palavras pagas: o contingente da subscrição e os pacotes comprados. O contingente mensal gratuito aplica-se apenas à interface web.
Enterprise a partir de 150.000 palavras/mês
Preços individuais para agências, ghostwriters e integrações de ferramentas. Responda brevemente a quatro pontos – entraremos em contacto no prazo de 24 horas.
Pagamento seguro via Stripe · cancelável a qualquer momento, sem período mínimo de fidelização
Resposta
Um campo com o resultado, um objeto com os valores de medição. Não é necessária mais estrutura.
{
"humanized_text": "…",
"ai_detection": {
"original": {
"human_mixed_percent": 18.42,
"human_percent": 8.29,
"mixed_percent": 10.13,
"ai_percent": 81.58
},
"humanized": {
"human_mixed_percent": 96.17,
"human_percent": 83.04,
"mixed_percent": 13.13,
"ai_percent": 3.83
}
}
}humanized_text
A versão revista no idioma do texto de entrada. A estrutura e o comprimento permanecem próximos do original.
ai_detection.original
As probabilidades para o texto que enviaste: ai_percent, human_percent, mixed_percent e human_mixed_percent.
ai_detection.humanized
Os mesmos quatro valores para o resultado. A comparação de ambos os objetos é a verificação antes/depois da interface web.
X-Request-ID
Header que registas. Com ele, o suporte pode associar uma única execução sem que tenhas de enviar o teu texto novamente.
Os valores de IA são probabilidades de classe, não proporções de frases – e não são uma prova. Os detetores também classificam incorretamente textos humanos. Valores individuais podem ser nulos se não houver medição; a tua integração deve estar preparada para isso.
O que permanece
A estrutura da frase, as transições e a escolha das palavras são alteradas. O conteúdo, pelo qual o seu produto se responsabiliza, permanece inalterado.
Significado
As afirmações permanecem afirmações. Nada é adicionado que não estivesse no texto de entrada.
Números e identificadores
Números de processo, DOIs, ISBNs, números de artigo: as sequências de caracteres são mantidas, não redefinidas.
Nomes e nomes próprios
Pessoas, instituições, produtos e locais mantêm a sua grafia.
Números, datas e unidades
Os valores medidos permanecem não arredondados, não convertidos e no seu lugar.
Termos técnicos e abreviaturas
A terminologia não é trocada por uma palavra do dia a dia, apenas porque soa mais comum.
Registo e tratamento
Formal ou informal, sóbrio ou narrativo: o nível de linguagem do texto de entrada é mantido.
Faturação
A API não tem tarifas próprias. Debita do mesmo saldo que a ferramenta no navegador utiliza.
São faturadas as palavras de entrada
É contado exatamente o texto que envias. O comprimento da resposta não influencia o preço.
Através da API são utilizadas palavras pagas
O contingente mensal gratuito aplica-se à interface web. A API pública acede exclusivamente a saldo pago.
Rejeitado não significa faturado
Pedidos que falham devido a um limite não são colocados em fila nem cobrados. Em caso de erros repetíveis, a reserva é libertada.
Sem segundo contrato
O saldo e a subscrição são geridos através da sua conta existente e podem ser cancelados lá. Para a API, não há custos adicionais.
curl 'https://api.studytexter.com/v1/balance' \
--header "Authorization: Bearer $STUDYTEXTER_API_KEY"
{
"balance": {
"subscription": null,
"subscription_words_remaining": 0,
"purchased_words_remaining": 12000,
"total_api_words_available": 12000
}
}Segurança
Quatro pontos que devem ser esclarecidos antes da integração.
A chave permanece do lado do servidor
stx_live_… deve ser guardado num Secret-Manager – não em browser-bundles, aplicações móveis, URLs, prompts ou logs. Redija o cabeçalho de Authorization antes de registar os pedidos.
Visível uma vez, revogável a qualquer momento
O segredo completo é exibido apenas uma vez durante a criação. A criação, listagem e revogação são feitas exclusivamente através da página de chaves, após o login.
Uma chave, muitos pedidos
A mesma chave autentica um número ilimitado de pedidos, sequencialmente ou em paralelo. A Idempotency-Key é outra coisa: um identificador de pedido, não um segredo.
Sem treino com os seus textos
Os seus textos são processados para o pedido. Não os utilizamos para treinar modelos de IA.
Perguntas
Uma interface REST através da qual podes rever textos de IA programaticamente para que soem mais naturais. Um POST para /v1/humanize com o teu texto, e recebes de volta a versão humanizada e os valores de deteção de IA para ambas as versões. Por trás disto, corre o mesmo processamento que no Humanizador de IA no navegador.
Em termos de conteúdo, sim. Por trás da API do Humanizador de IA estão a mesma deteção de idioma, a mesma medição de palavras e o mesmo processamento que por trás do Humanizador de IA na interface web. Apenas o acesso – Bearer-Token em vez de login – e o saldo são diferentes: através da API pública são utilizadas exclusivamente palavras pagas.
Como uma ferramenta. Define-se uma definição de ferramenta com um único campo obrigatório – o texto – e o agente chama-a quando um resultado precisa de ser revisto. Isto funciona igualmente bem no LangChain, CrewAI, no SDK da Anthropic ou num loop próprio. Para os modelos, as descrições estão adicionalmente disponíveis como OpenAPI 3.1, como Markdown e como llms.txt.
Registe-se gratuitamente ou inicie sessão, abra a página de chaves na aplicação e crie uma chave. Verá o segredo completo apenas uma vez – copie-o imediatamente para o seu Secret-Manager. Pode revogá-lo lá a qualquer momento.
Através de um Bearer-Token no cabeçalho de Authorization: Authorization: Bearer stx_live_… A mesma chave é válida para /v1/humanize e /v1/balance e pode autenticar muitos pedidos sequencialmente ou em paralelo. Deve ser usada exclusivamente em código do lado do servidor.
Com texto de todos os modelos comuns – ChatGPT, Claude, Gemini, DeepSeek, Llama, Mistral e outros. A API recebe texto, não um nome de modelo: o que importa são os padrões no rascunho, não a sua origem.
Não prometemos isso. A API fornece uma formulação mais natural e, adicionalmente, os valores de IA medidos para o original e o resultado. Estes valores são probabilidades de classe de um detetor – não uma prova nem uma garantia. Os detetores alteram os seus modelos, chegam a avaliações diferentes dependendo do fornecedor e também classificam incorretamente textos puramente humanos. O que recebes é uma comparação compreensível de antes/depois, que podes exibir ou registar no teu produto.
Não, e também não podes. O idioma dominante do texto de entrada é detetado e mantido na resposta – português e mais de 40 outros. A API não aceita um campo `language`.
Sim. São faturadas exatamente as palavras de entrada medidas, independentemente do comprimento da resposta. Através da API pública são utilizadas exclusivamente palavras pagas; o contingente mensal gratuito aplica-se à interface web. Podes consultar o estado atual com GET /v1/balance.
Sim, por utilizador: 60 novos pedidos por 60 segundos, 60 em processamento simultâneo e 30 consultas de saldo por minuto. Pedidos acima disso são rejeitados com 429, não são colocados em fila e não são faturados. Quando disponível, o Retry-After indica o tempo de espera.
Em caso de erro com error.retryable=true, a reserva foi libertada – uma nova tentativa é segura. Se a ligação for interrompida sem qualquer resposta, não sabes o resultado: para este caso, existe a Idempotency-Key opcional. Com a mesma chave e o mesmo texto, recebes a resposta guardada em vez de uma segunda faturação.
A utilização é feita através da sua conta StudyTexter e é faturada por essa via, mesmo que os seus próprios utilizadores acionem a chamada. O que se aplica contratualmente está estipulado nos nossos TCG; para volumes maiores ou questões sobre a utilização, contacte-nos previamente.
Crie uma chave e envie o primeiro request
POST /v1/humanize · Faturação por palavras de entrada · Sem período mínimo de fidelização