About this endpoint
What it does
Generates an EPUB manuscript file from the book metadata and content you send in the request body. The input includes required book title, author names, language, and chapter content, and the success response schema is an object with no documented properties.
Request Body
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| isbn | String | No | Optional ISBN identifier, maximum length 50. |
| eisbn | String | No | Optional electronic ISBN identifier, maximum length 50. |
| chapters | Object Array | Yes | Chapter objects, minimum 1 and maximum 100 items. Each chapter must include title and blocks.title: String, 1-300 characters.blocks: array of content blocks, minimum 1 and maximum 800 items. |
| chapters[].title | String | Yes | Chapter title, 1-300 characters. |
| chapters[].blocks | Object Array | Yes | Chapter content blocks, minimum 1 and maximum 800 items. Allowed block types: paragraph, heading, image, list, table, sceneBreak. |
| chapters[].blocks[].type | ENUM | Yes | Block type. Allowed values: paragraph, heading, image, list, table, sceneBreak. |
| chapters[].blocks[].runs | Object Array | Yes (if block type is paragraph or heading) | Inline text runs for paragraph and heading blocks. Each run must include text and may include formatting fields such as bold, italic, underline, subscript, superscript, and color.See schema for nested fields. |
| chapters[].blocks[].level | Number | Yes (if block type is heading) | Heading level. Allowed values: 1, 2, 3, 4. |
| chapters[].blocks[].align | ENUM | No | Text alignment. Allowed values: left, center, right, justify. |
| chapters[].blocks[].lineHeight | String | No | Line height as a numeric string matching ^[0-9](\\.[0-9]+)?$. |
| chapters[].blocks[].dataUri | String | Yes (if block type is image) | Image data URI, 1-15,000,000 characters. |
| chapters[].blocks[].alt | String | No | Alternative text for the image, maximum length 500. |
| chapters[].blocks[].caption | String | No | Image caption, maximum length 500. |
| chapters[].blocks[].widthFrac | Number | No | Image width fraction between 0.1 and 1. |
| chapters[].blocks[].ordered | Boolean | Yes (if block type is list) | Whether the list is ordered. |
| chapters[].blocks[].items | Object Array | Yes (if block type is list) | List items, minimum 1 and maximum 300 items. Each list item is an array of text runs; each run requires text. |
| chapters[].blocks[].rows | Object Array | Yes (if block type is table) | Table rows, minimum 1 and maximum 200 items. Each row includes cells; each row can also include header. |
| chapters[].blocks[].rows[].cells | Object Array | Yes | Table cells for the row, minimum 1 and maximum 30 items. Each cell is an array of text runs; each run requires text. |
| chapters[].blocks[].rows[].header | Boolean | No | Marks the row as a header row. |
| chapters[].blocks[].type | ENUM | Yes | Block type. Allowed values: paragraph, heading, image, list, table, sceneBreak. |
| chapters[].partTitle | String | No | Optional part title for the chapter, maximum length 300. |
| language | String | Yes | Language code or identifier, 2-10 characters. |
| stableId | String | No | Optional stable identifier, maximum length 200. |
| subtitle | String | No | Optional subtitle, maximum length 300. |
| bookTitle | String | Yes | Book title, 1-300 characters. |
| watermark | Boolean | No | Whether to include a watermark. |
| authorNames | String Array | Yes | Author names, minimum 1 and maximum 50 items. Each name must be 1-200 characters. |
| copyrightYear | Integer | No | Copyright year between 1500 and 3000. |
| publisherName | String | No | Publisher name, maximum length 300. |
| epigraphBlocks | Object Array | No | Optional epigraph content blocks, minimum 1 and maximum 800 items. Allowed block types: paragraph, heading, image, list, table, sceneBreak. |
| copyrightHolder | String | No | Copyright holder name, maximum length 300. |
| dedicationBlocks | Object Array | No | Optional dedication content blocks, minimum 1 and maximum 800 items. Allowed block types: paragraph, heading, image, list, table, sceneBreak. |
| coverImageDataUri | String | No | Cover image data URI, maximum length 15,000,000 characters. |
Response
Returns the e-book file itself as binary file.



