API para desarrolladores - Humaniza, cita, condensa y traduce documentos

Add to Agent

Usa HumanPen en Claude Code, Codex, Cursor o cualquier agente de codificación. Los tres métodos comparten el mismo saldo de créditos.

Sin configuración. Copia y pega este texto a tu agente: leerá las instrucciones de instalación por su cuenta, clonará la skill en el directorio donde carga sus skills, y te pedirá una clave.

Prompt

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

Cada método necesita una clave de API.

Obtener clave de API

Resumen

La API de HumanPen está pensada para integraciones del lado del servidor: permite subir un documento y crear una tarea de procesamiento asíncrona en una sola solicitud, para luego consultar el progreso y descargar el resultado editable mediante un enlace temporal.

Ruta base de la API: https://api.humanpen.net/v1
Formato de respuesta: Los endpoints de negocio devuelven una estructura JSON unificada; los endpoints de contenido de archivo devuelven datos binarios. El esquema de OpenAPI usa JSON estándar.

Autenticación

Crea una clave en «Claves de API» y envíala como Bearer Token en el encabezado Authorization de cada solicitud protegida. La clave completa se puede copiar en cualquier momento desde la lista de claves.

HTTP

Authorization: Bearer hp_xxx

Las claves de API solo son adecuadas para uso en servicios de backend. No las coloques en navegadores, apps móviles, repositorios públicos ni registros del lado del cliente.

Crea tu primera tarea

Envía el documento y la configuración de procesamiento en una sola solicitud, y usa el ID de tarea devuelto para consultar el progreso.

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."

Referencia de la API

Lista los endpoints principales en el orden en que se llaman. Expande cualquier endpoint para ver sus parámetros, cuerpo de solicitud, tipos de campo, campos obligatorios, respuestas de éxito y códigos de error.

Leyendo el esquema de OpenAPI...

Recursos de referencia

OpenAPI es el único contrato estructurado de la API; docs.md es la guía de integración completa y legible; llms.txt es el índice resumido para que los agentes descubran estos recursos.

Guía de integración completa en Markdownhttps://api.humanpen.net/v1/docs.mdOpenAPIhttps://api.humanpen.net/v1/openapi.jsonÍndice para agentes llms.txthttps://humanpen.net/llms.txt

Respuestas y depuración

Tanto las respuestas JSON de éxito como las de error incluyen los campos estables code, message y data; el código de estado HTTP sigue expresando el resultado de la solicitud.

X-Request-ID

Cada respuesta incluye un ID de solicitud. Adjunta este valor al reportar un problema: permite correlacionar directamente los registros de la API, la cola y los workers.