HumanPen
시작하기

개발자 API

표준 API를 통해 문서 처리 작업을 생성하고, 진행 상황을 조회하며, 처리 결과를 다운로드합니다.

Add to Agent

Claude Code, Codex, Cursor 또는 모든 코딩 에이전트에서 HumanPen을 사용하세요. 세 가지 방식 모두 동일한 크레딧 잔액을 공유합니다.

설정 불필요. 이 문장을 에이전트에 붙여넣으면, 에이전트가 설치 안내를 읽고 스킬을 자기 스킬 디렉터리에 클론한 뒤 키를 요청합니다.

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

모든 방식에 API 키가 필요합니다.

API 키 받기

개요

HumanPen API는 서버 측 통합을 위해 설계되었으며, 한 번의 요청으로 문서를 업로드하고 비동기 처리 작업을 생성한 후, 진행 상황을 조회하고 임시 링크를 통해 편집 가능한 결과를 다운로드할 수 있습니다.

API 기본 경로
https://api.humanpen.net/v1
응답 형식
비즈니스 엔드포인트는 통일된 JSON 구조를 반환하고, 파일 콘텐츠 엔드포인트는 바이너리를 반환합니다. OpenAPI 스키마는 표준 JSON입니다.

인증

'API 키'에서 키를 생성하고, 보호된 모든 요청의 Authorization 헤더에 Bearer 토큰으로 보냅니다. 전체 키는 키 목록에서 언제든 다시 복사할 수 있습니다.

HTTP
Authorization: Bearer hp_xxx

API 키는 백엔드 서비스 전용입니다. 브라우저, 모바일 앱, 공개 저장소 또는 클라이언트 로그에 넣지 마세요.

첫 번째 작업 생성

한 번의 요청으로 문서와 처리 설정을 제출한 후, 반환된 작업 ID로 진행 상황을 조회합니다.

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 참조

호출 순서대로 핵심 엔드포인트를 나열합니다. 엔드포인트를 펼치면 매개변수, 요청 본문, 필드 유형, 필수 여부, 성공 응답, 오류 상태 코드를 확인할 수 있습니다.

OpenAPI 스키마 불러오는 중...

참고 자료

OpenAPI는 API의 유일한 구조화된 계약이고, docs.md는 처음부터 끝까지 읽을 수 있는 연동 가이드, llms.txt는 에이전트가 이 자료들을 찾도록 돕는 간략한 인덱스입니다.

전체 Markdown 통합 가이드OpenAPIllms.txt 에이전트 인덱스

응답 및 문제 해결

성공과 실패 비즈니스 JSON 모두 안정적인 code, message, data 필드를 포함합니다. HTTP 상태 코드는 여전히 요청 결과를 나타냅니다.

X-Request-ID

모든 응답에는 요청 ID가 포함됩니다. 문제를 보고할 때 이 값을 함께 제공하면 API, 큐 및 Worker 로그를 직접 연결할 수 있습니다.