API développeur - Réduction IA, références, condensation et traduction de documents

Add to Agent

Utilisez HumanPen depuis Claude Code, Codex, Cursor ou tout agent de codage. Les trois méthodes partagent le même solde de crédits.

Aucune configuration nécessaire. Collez ce texte dans votre agent. Il lira le guide d'installation, clonera le skill dans le répertoire où il charge ses skills et vous demandera une clé.

Prompt

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

Chaque méthode nécessite une clé API.

Obtenir une clé API

Vue d'ensemble

L'API HumanPen est conçue pour les intégrations côté serveur. Importez un document et créez une tâche asynchrone en une seule requête, puis suivez la progression et téléchargez le résultat modifiable via un lien temporaire.

Chemin de base de l'API: https://api.humanpen.net/v1
Format de réponse: Les endpoints métier renvoient une enveloppe JSON unifiée ; les endpoints de contenu de fichier renvoient des données binaires. Le schéma OpenAPI est du JSON standard.

Authentification

Créez une clé dans la section « Clés API » et envoyez-la en tant que Bearer Token dans l'en-tête Authorization de chaque requête protégée. La clé complète peut être recopiee à tout moment depuis la liste des clés.

HTTP

Authorization: Bearer hp_xxx

Les clés API sont réservées aux services backend. Ne les exposez pas dans les navigateurs, les applications mobiles, les dépôts publics ou les journaux côté client.

Créer votre première tâche

Envoyez un document et ses options en une seule requête, puis interrogez l'ID de tâche retourné pour suivre la progression.

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

Référence de l'API

Les endpoints principaux sont listés dans l'ordre d'appel typique. Dépliez un endpoint pour consulter ses paramètres, son corps de requête, les types de champs, les champs obligatoires, les réponses de succès et les codes d'erreur.

Chargement du schéma OpenAPI...

Ressources de référence

OpenAPI est le contrat structure de référence. docs.md est le guide d'intégration complet, et llms.txt est un index concis permettant aux agents de découvrir ces ressources.

Guide d'intégration complet en Markdownhttps://api.humanpen.net/v1/docs.mdOpenAPIhttps://api.humanpen.net/v1/openapi.jsonIndex llms.txt pour agentshttps://humanpen.net/llms.txt

Réponses et débogage

Les réponses JSON de succès et d'échec partagent les champs stables code, message et data ; les codes de statut HTTP décrivent toujours le résultat de la requête.

X-Request-ID

Chaque réponse inclut un identifiant de requête. Joignez-le dans vos demandes de support pour faciliter la corrélation entre les journaux API, file d'attente et worker.