Docs / Advanced & Developer Hub / REST API & Automation

REST API & Automation

Comprehensive REST API documentation, Axum backend endpoints, and SvelteKit routes.

Preview Content
Please note that the details on this page are pre-content drafts. More detailed technical specifications, architectural breakdowns, and updated guides will be added soon.

Core REST Endpoints

Axum ML Inference Endpoints (http://localhost:8123)

Method & RouteDescription
GET /healthServer status, version, accelerator, and active providers
GET /system/hardwareHardware telemetry, VRAM usage, and model reload state
POST /system/deviceSwitch active provider ("auto", "directml", "cuda", "coreml", "cpu")
GET /system/telemetryActive and queued OCR jobs, CPU & host RAM stats
POST /pages/analyzeMultipart image upload -> detection, OCR, text regions
POST /pages/cleanMultipart image + regions JSON -> LaMa neural inpainting
POST /pages/preprocessNormalize and optimize page image bytes
POST /pages/stitchVertical two-panel canvas stitching
POST /pages/resliceMulti-image webtoon smart gutter slicing
GET /pages/reslice/statusReal-time percentage polling for smart reslice
POST /pages/reslice/cancelCancel ongoing smart reslice job
POST /pages/reslice/resetReset smart reslice worker state and initialize run ID

SvelteKit Web & Library Endpoints (http://localhost:8124/api)

Method & RouteDescription
GET /api/booksList all books with chapter counts and telemetry
POST /api/booksCreate a new book series in the library
GET /api/books/:idGet book metadata, chapter index, and preferences
POST /api/books/:id/chaptersCreate a new chapter under a book
GET /api/chapters/:idGet chapter pages, status, and translated regions
POST /api/chapters/:id/pagesUpload raw page images (multipart/form-data)
POST /api/chapters/:id/translateTrigger translation pipeline for a chapter
GET /api/chapters/:id/translateReal-time SSE progress event stream
DELETE /api/chapters/:id/translateCancel running chapter translation job
POST /api/translate-textDirect LLM text translation with dynamic dialogue memory
GET /api/system/hardwareQuery active GPU, VRAM limits, and hardware capabilities
POST /api/system/hardwareSet hardware provider and VRAM ceiling
GET /api/glossaryFetch compiled system preset themes and custom terms
POST /api/glossaryInsert or update custom glossary entries
GET /api/pages/:id/file?kind=outputRetrieve rendered page image (output, cleaned, original, thumb)
GET /api/mihon/*Mihon / Tachiyomi source protocol endpoints