Files
SnapOtter/apps/docs/vi/tools/files/epub-convert.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

1.6 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Chuyển đổi một EPUB sang PDF, DOCX, HTML hoặc Markdown. 7d94fc18ca97 human 799e72fe641c

Convert EPUB

Chuyển đổi một sách điện tử EPUB sang PDF, Word (DOCX), HTML hoặc Markdown. Các tài nguyên từ xa bên trong sách không được tải về.

API Endpoint

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

Nhận dữ liệu multipart form với một tệp EPUB và một trường JSON settings.

Parameters

Parameter Type Required Default Description
format string Yes - Định dạng đầu ra: pdf, docx, html, md

Example Request

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"}'

Example Response

Trả về 202 Accepted. Theo dõi tiến trình qua SSE tại /api/v1/jobs/{jobId}/progress.

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

Notes

  • Định dạng đầu vào được chấp nhận: .epub.
  • Các tài nguyên từ xa nhúng trong EPUB (ảnh, phông chữ bên ngoài) không được tải về vì lý do bảo mật.
  • Độ trung thực của hình ảnh trong đầu ra đã chuyển đổi có thể khác nhau tùy theo cấu trúc EPUB.
  • Việc chuyển đổi được xử lý bởi Pandoc trên máy chủ.