Add to Agent
Usa HumanPen da Claude Code, Codex, Cursor o qualsiasi coding agent. I tre metodi condividono lo stesso saldo crediti.
Zero configurazione. Incolla questo prompt nel tuo agent: leggerà da solo la guida all'installazione, clonerà la skill nella cartella da cui carica le skill e ti chiederà una chiave.
Install the HumanPen skill by following the instructions at https://humanpen.net/install/skill-install.mdOgni metodo richiede una chiave API.
Ottieni una chiave APIPanoramica
L'API di HumanPen è pensata per integrazioni lato server: puoi caricare un documento e creare un lavoro asincrono in un'unica richiesta, poi seguirne l'avanzamento e scaricare il risultato modificabile tramite un link temporaneo.
- Percorso base dell'API
https://api.humanpen.net/v1- Formato della risposta
- Gli endpoint applicativi restituiscono una struttura JSON uniforme; gli endpoint per i contenuti dei file restituiscono dati binari. Lo schema OpenAPI usa JSON standard.
Autenticazione
Crea una chiave nella sezione "Chiavi API" e inviala come Bearer Token nell'header Authorization di ogni richiesta protetta. La chiave completa può essere ricopiata in qualsiasi momento dall'elenco.
Authorization: Bearer hp_xxxLe chiavi API sono destinate solo ai servizi backend. Non inserirle in browser, app mobile, repository pubblici o log lato client.
Crea il tuo primo lavoro
Invia documento e impostazioni di elaborazione in un'unica richiesta, poi interroga l'avanzamento con l'ID del lavoro restituito.
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."Riferimento API
Gli endpoint principali sono elencati nell'ordine tipico di utilizzo. Espandi ciascuno per vederne parametri, corpo della richiesta, tipi di campo, requisiti, risposte di successo e codici di errore.
Risorse di riferimento
OpenAPI è l'unico contratto strutturato dell'API; docs.md è la guida completa all'integrazione, mentre llms.txt è un indice sintetico che aiuta gli agent a scoprire queste risorse.
https://api.humanpen.net/v1/docs.mdOpenAPIhttps://api.humanpen.net/v1/openapi.jsonIndice llms.txt per agenthttps://humanpen.net/llms.txtRisposte e risoluzione dei problemi
Le risposte JSON, sia di successo che di errore, contengono sempre i campi code, message e data; il codice di stato HTTP continua a esprimere l'esito della richiesta.
X-Request-ID
Ogni risposta restituisce un ID richiesta. Includilo quando segnali un problema: permette di collegare direttamente i log di API, coda e worker.