Get Started with Aeion Manuscript

Go to Manuscript → Library → Import.

Import EPUB (API):

```bash POST /manuscript/import Content-Type: multipart/form-data

file: [EPUB file] ```

Response:

typescript { "id": "book-xxx", "title": "The Great Gatsby", "author": "F. Scott Fitzgerald", "publisher": "Scribner", "language": "en", "totalChapters": 9, "totalWords": 47094, "estimatedReadingTime": 188, // minutes "chapters": [ { "id": "ch-001", "title": "Chapter 1", "wordCount": 5234, "order": 1 }, // ... ], "tableOfContents": [ { "title": "Chapter 1", "href": "#ch-001", "level": 1 }, // ... ] }

EPUB Structure Parsing:

typescript interface EPUBImportResult { id: string; title: string; author: string; description?: string; coverImage?: string; chapters: Array<{ id: string; title: string; content: string; // Cleaned HTML wordCount: number; }>; tableOfContents: Array<{ title: string; href: string; level: number; }>; }

Import from URL:

bash POST /manuscript/import/url { "url": "https://example.com/book.epub", "title": "Custom Title", "author": "Custom Author" }

Bulk Import:

bash POST /manuscript/import/bulk { "files": ["book1.epub", "book2.epub", "book3.epub"] }

Library View (API):

bash GET /manuscript/books

Response:

typescript { "books": [ { "id": "book-xxx", "title": "The Great Gatsby", "author": "F. Scott Fitzgerald", "cover": "https://...", "percentComplete": 45, "totalChapters": 9, "currentChapter": 4, "lastReadAt": "2026-05-10T14:30:00Z" } ], "meta": { "total": 12, "reading": 3, "completed": 9 } }

Go to Manuscript → Book → Generate Flashcards.

Generate Flashcards (API):

bash POST /manuscript/ai/flashcards { "text": "The protagonist, Jay Gatsby, throws lavish parties at his mansion in West Egg. He accumulates his wealth through questionable means, bootlegging alcohol during Prohibition. His ultimate goal is to reunite with Daisy Buchanan, his lost love from Louisville.", "count": 5 }

Response:

typescript { "flashcards": [ { "front": "Who is the protagonist of The Great Gatsby?", "back": "Jay Gatsby" }, { "front": "What does Gatsby do for a living?", "back": "He accumulates wealth through bootlegging alcohol during Prohibition" }, { "front": "Where does Gatsby live?", "back": "In a lavish mansion in West Egg, Long Island" }, { "front": "What is Gatsby's ultimate goal?", "back": "To reunite with Daisy Buchanan, his lost love" }, { "front": "What era is The Great Gatsby set in?", "back": "The Roaring Twenties, during Prohibition (1920-1933)" } ] }

Vocabulary with Definitions (API):

bash POST /manuscript/ai/vocabulary { "text": "The protagonist's ostentatious display of wealth was a manifestation of his deep-seated insecurity." }

Response:

typescript { "vocabulary": [ { "word": "protagonist", "definition": "The main character of a story; the central figure around whom the plot revolves." }, { "word": "ostentatious", "definition": "Characterized by vulgar or pretentious display; designed to impress or attract notice." }, { "word": "manifestation", "definition": "A tangible or visible form of an idea, quality, or emotion." }, { "word": "deep-seated", "definition": "Firmly established; difficult to remove or change." }, { "word": "insecurity", "definition": "Lack of confidence or certainty; anxiety about one's worth or abilities." } ] }

Study Guide Generation (API):

bash POST /manuscript/ai/study-guide { "bookId": "book-xxx" }

Response:

typescript { "key_concepts": [ "The American Dream and its corruption", "Social class and class conflict", "The past's influence on the present", "Symbolism of the green light", "The hollowness of upper-class society" ], "discussion_questions": [ "How does Gatsby's wealth affect his identity?", "What is the significance of the novel's title?", "How does Fitzgerald portray the 'new money' vs 'old money'?", "What role does geography play in the novel?", "How does the novel critique the American Dream?" ], "important_quotes": [ { "quote": "So we beat on, boats against the current, borne back ceaselessly into the past.", "source": "Ch. 9" }, { "quote": "I hope she'll be a fool—that's the best thing a girl can be in this world, a beautiful little fool.", "source": "Ch. 1, Daisy" } ] }

Go to Manuscript → Book → Settings → Reading Goal.

Set Reading Goal (API):

bash PATCH /manuscript/books/{bookId}/goal { "goalType": "chapters", "goalTarget": 9, "goalStartDate": "2026-05-01", "goalEndDate": "2026-05-15" }

Response:

typescript { "bookId": "book-xxx", "goalType": "chapters", "target": 9, "current": 4, "percentComplete": 44, "onTrack": true, "daysRemaining": 10, "requiredDailyRate": 0.5 }

Add Annotation (API):

bash POST /manuscript/annotations { "book": "book-xxx", "chapter": "ch-001", "type": "highlight", "text": "So we beat on, boats against the current, borne back ceaselessly into the past.", "color": "yellow", "tags": ["important-quote", "theme"] }

Update Annotation:

bash PATCH /manuscript/annotations/{annotationId} { "note": "This is the final line of the novel and encapsulates the futility of Gatsby's efforts.", "tags": ["important-quote", "theme", "finale"] }

List Annotations (API):

bash GET /manuscript/annotations?bookId=book-xxx

Response:

typescript { "annotations": [ { "id": "ann-xxx", "type": "highlight", "text": "So we beat on, boats against the current...", "chapter": "Chapter 9", "color": "yellow", "tags": ["important-quote", "theme"] }, { "id": "ann-yyy", "type": "note", "note": "Gatsby's obsession with Daisy ultimately destroys him.", "chapter": "Chapter 5", "createdAt": "2026-05-10T14:30:00Z" } ], "meta": { "total": 24, "byType": { "highlight": 15, "note": 6, "bookmark": 3 } } }

Sync Reading Progress (API):

bash POST /manuscript/reader/progress { "bookId": "book-xxx", "chapterId": "ch-004", "position": 5234, "timestamp": "2026-05-11T10:30:00Z" }

Get Reader Stats (API):

bash GET /manuscript/reader/stats

Response:

typescript { "totalBooks": 12, "booksCompleted": 9, "totalPagesRead": 3240, "totalReadingTime": 4582, "averageSessionLength": 35, "favoriteGenres": ["literary-fiction", "classics"], "currentStreak": 12, "longestStreak": 21 }