HumanPen
Começar

API para desenvolvedores

Crie tarefas de processamento de documentos, consulte o progresso e baixe os resultados por meio de uma API padrão.

Add to Agent

Use o HumanPen no Claude Code, Codex, Cursor ou qualquer agente de codificação. As três formas compartilham o mesmo saldo de créditos.

Sem configuração. Copie e cole esta frase para seu agente. Ele lerá o guia de instalação, clonará a skill no diretório de onde carrega skills e pedirá uma chave a você.

Prompt
Install the HumanPen skill by following the instructions at https://humanpen.net/install/skill-install.md

Todas as formas exigem uma chave de API.

Obter chave de API

Visão geral

A API do HumanPen é voltada para integração no lado do servidor. Envie um documento e crie uma tarefa assíncrona em uma única requisição, consulte o progresso e baixe o resultado editável por meio de um link temporário.

Caminho base da API
https://api.humanpen.net/v1
Formato de resposta
Endpoints de negócio retornam uma estrutura JSON padronizada; endpoints de conteúdo de arquivo retornam dados binários. O Schema OpenAPI usa JSON padrão.

Autenticação

Crie uma chave em "Chaves de API" e envie-a como Bearer Token no header Authorization de cada requisição protegida. A chave completa pode ser copiada novamente a qualquer momento na lista de chaves.

HTTP
Authorization: Bearer hp_xxx

Chaves de API são exclusivas para uso em backends. Não as coloque em navegadores, aplicativos móveis, repositórios públicos ou logs do lado do cliente.

Crie sua primeira tarefa

Envie o documento e as configurações de processamento em uma única requisição e use o ID da tarefa retornado para consultar o progresso.

curl -X POST "https://api.humanpen.net/v1/jobs/humanize" \
  -H "Authorization: Bearer $HP_API_KEY" \
  -F "file=@paper.docx" \
  -F "turnitin_file=@turnitin-report.pdf" \
  -F "strategy=balanced" \
  -F "additional_instructions=Keep terminology and citations unchanged."

Referência da API

Endpoints principais listados na ordem de chamada. Expanda qualquer endpoint para ver parâmetros, corpo da requisição, tipos de campo, campos obrigatórios, respostas de sucesso e códigos de erro.

Carregando Schema OpenAPI...

Recursos de referência

O OpenAPI é o contrato estruturado definitivo; docs.md é o guia completo de integração, e llms.txt é um índice resumido para que agentes descubram esses recursos.

Guia completo de integração em MarkdownOpenAPIÍndice llms.txt para agentes

Respostas e depuração

Respostas JSON de sucesso e falha incluem campos estáveis de code, message e data; os códigos de status HTTP ainda descrevem o resultado da requisição.

X-Request-ID

Toda resposta retorna um ID de requisição. Ao relatar problemas, inclua esse valor para correlacionar os logs da API, fila e worker.