Entwickler-API – KI-Rate senken, Zitierstil, Kürzen, Übersetzen

Add to Agent

Verwenden Sie HumanPen in Claude Code, Codex, Cursor oder jedem anderen Coding-Agent. Alle drei Wege nutzen dasselbe Credit-Guthaben.

Keine Konfiguration nötig. Fügen Sie dies in Ihren Agent ein. Er liest die Installationsanleitung, klont den Skill in das Verzeichnis, aus dem er Skills lädt, und fragt Sie nach einem Schlüssel.

Prompt

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

Jeder Weg benötigt einen API-Schlüssel.

API-Schlüssel erhalten

Übersicht

Die HumanPen API ist für serverseitige Integrationen konzipiert. Laden Sie ein Dokument hoch und erstellen Sie in einer Anfrage einen asynchronen Auftrag, überwachen Sie den Fortschritt und laden Sie das bearbeitbare Ergebnis über eine temporäre URL herunter.

API-Basispfad: https://api.humanpen.net/v1
Antwortformat: Geschäftsendpunkte liefern eine einheitliche JSON-Struktur; Dateiinhalt-Endpunkte liefern Binärdaten. Das OpenAPI-Schema verwendet Standard-JSON.

Authentifizierung

Erstellen Sie unter „API-Schlüssel“ einen Schlüssel und senden Sie ihn als Bearer-Token im Authorization-Header jeder geschützten Anfrage. Der vollständige Schlüssel kann jederzeit aus der Schlüsselliste kopiert werden.

HTTP

Authorization: Bearer hp_xxx

API-Schlüssel sind für Backend-Dienste bestimmt. Verwenden Sie sie nicht in Browsern, mobilen Apps, öffentlichen Repositories oder clientseitigen Logs.

Ersten Auftrag erstellen

Senden Sie ein Dokument und seine Einstellungen in einer einzigen Anfrage und fragen Sie dann die zurückgegebene Auftrags-ID ab.

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

API-Referenz

Kernendpunkte sind nach dem typischen Workflow sortiert. Klappen Sie einen Endpunkt auf, um Parameter, Anfragetexte, Feldtypen, Anforderungen, Erfolgsantworten und Fehlerstatus einzusehen.

OpenAPI-Schema wird geladen…

Referenzressourcen

OpenAPI ist die maßgebliche strukturierte Spezifikation der Schnittstelle. docs.md ist die vollständige Integrationsanleitung, während llms.txt ein kompakter Index ist, der Agents beim Auffinden dieser Ressourcen hilft.

Vollständige Markdown-Integrationsanleitunghttps://api.humanpen.net/v1/docs.mdOpenAPIhttps://api.humanpen.net/v1/openapi.jsonllms.txt-Agent-Indexhttps://humanpen.net/llms.txt

Antworten und Fehlerbehebung

Erfolgreiche und fehlgeschlagene Geschäfts-JSON-Antworten verwenden stabile code-, message- und data-Felder; HTTP-Statuscodes beschreiben weiterhin das Anfrageergebnis.

X-Request-ID

Jede Antwort enthält eine Anfrage-ID. Geben Sie diese bei Supportanfragen an, um API-, Warteschlangen- und Worker-Logs zu korrelieren.