Files
SnapOtter/apps/docs/ko/tools/files/epub-convert.md
T
SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520)
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
2026-07-15 21:55:51 +08:00

1.5 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
EPUB를 PDF, DOCX, HTML, 또는 Markdown으로 변환합니다. cb39f254ff2f human 19ff29a02151

EPUB에서 변환

EPUB 전자책을 PDF, Word(DOCX), HTML, 또는 Markdown으로 변환합니다. 책 내부의 원격 리소스는 가져오지 않습니다.

API 엔드포인트

POST /api/v1/tools/files/epub-convert

EPUB 파일과 JSON settings 필드가 포함된 multipart form data를 받습니다.

매개변수

매개변수 유형 필수 기본값 설명
format string - 출력 형식: pdf, docx, html, md

요청 예시

curl -X POST http://localhost:1349/api/v1/tools/files/epub-convert \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@book.epub" \
  -F 'settings={"format": "pdf"}'

응답 예시

202 Accepted을 반환합니다. /api/v1/jobs/{jobId}/progress에서 SSE를 통해 진행 상황을 추적하세요.

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

참고 사항

  • 허용 입력 형식: .epub.
  • EPUB에 임베디드된 원격 리소스(외부 이미지, 폰트)는 보안을 위해 가져오지 않습니다.
  • 변환된 출력의 이미지 충실도는 EPUB 구조에 따라 달라질 수 있습니다.
  • 변환은 서버의 Pandoc이 처리합니다.