電子書籍EPUB変換API - プロフェッショナルなEPUB 3.0生成

構造化コンテンツからカバーページ、目次、多言語サポート、7つのテンプレートを備えた有効なEPUB 3.0電子書籍を生成。PDF APIと同じ入力形式 — 即時生成。

何ができますか?
有効なEPUB 3.0出力

適切なOPFメタデータ、NCX目次、XHTMLチャプター、埋め込みカバー画像を備えたリフロー可能なEPUB電子書籍を生成。すべての主要な電子書籍リーダーと互換性があります。

7つのプロフェッショナルテンプレート

モダン小説、エレガント小説、学術論文、ビジネスレポート、料理本、旅行ガイド、テクニカルマニュアルから選択 — それぞれ独自のスタイリング。

21以上の言語

目次の見出し、章番号、著作権テキストが自動翻訳。英語からブルガリア語、ドイツ語、日本語、アラビア語など。

99.9 % 稼働時間
レスポンス
20 req/s
2 クレジット / リクエスト

Convert to EPUB

POST https://api.yeb.to/v1/ebooks/epub/convert-from-file
パラメータ 必須 説明
api_key string Yes Your API authentication key (send in Authorization header or as parameter)
file_url string Yes Public URL to JSON file containing book data (metadata, chapters, options)
Same input as PDF API. Use the exact same JSON structure as the Ebooks to PDF API. Simply change the endpoint URL to get EPUB output instead of PDF.

JSON File Structure

Your JSON file at file_url should contain:

パラメータ 必須 説明
template string Yes Template name: modern-novel, elegant-novel, academic-paper, business-report, cookbook, travel-guide, technical-manual
metadata object Yes Book metadata (title, author, etc.)
metadata.title string Yes Book title
metadata.author string Yes Author name
metadata.language string Optional Language code (e.g., en, bg, de). Affects TOC heading, chapter numbering, copyright text. Default: en. Supports 21+ languages.
metadata.description string Optional Book description (embedded in EPUB metadata)
metadata.year integer Optional Publication year (default: current year)
metadata.publisher string Optional Publisher name
metadata.isbn string Optional ISBN number (added as dc:identifier in OPF)
metadata.subtitle string Optional Book subtitle (shown on title page)
metadata.series string Optional Book series name (shown on title page)
metadata.cover_image string Optional Cover image URL (downloaded and embedded in EPUB)
chapters array Yes Array of chapter objects (max: 100)
chapters[].title string Yes Chapter title
chapters[].subtitle string Optional Chapter subtitle
chapters[].content string Yes Chapter content (plain text or HTML). Paragraphs separated by \n\n are auto-wrapped in <p> tags.
options object Optional Customization options
options.include_cover boolean Optional Include cover page if cover_image provided (default: true)
options.include_copyright boolean Optional Include copyright page (default: true)
options.font_size string Optional Base font size, e.g., 12pt (default: 12pt)
options.line_height string Optional Line height, e.g., 1.6 (default: 1.6)
texts object Optional Override auto-translated texts (copyright_text, publisher_text, chapter_number_format, toc_title, etc.)

JSON File Example

1. Create book.json on your server:
{
  "template": "elegant-novel",
  "metadata": {
    "title": "The Great Gatsby",
    "author": "F. Scott Fitzgerald",
    "subtitle": "A Novel of the Jazz Age",
    "description": "A story of decadence and excess...",
    "year": 1925,
    "publisher": "Charles Scribner's Sons",
    "isbn": "978-0-7432-7356-5",
    "language": "en",
    "cover_image": "https://example.com/gatsby-cover.jpg"
  },
  "chapters": [
    {
      "title": "Chapter I",
      "content": "In my younger and more vulnerable years...\n\nAnd, after boasting this way..."
    },
    {
      "title": "Chapter II",
      "content": "About half way between West Egg and New York..."
    }
  ],
  "options": {
    "font_size": "12pt",
    "line_height": "1.6",
    "include_copyright": true
  }
}
2. Upload to your server (e.g., https://yourdomain.com/books/book.json)
3. Call the API:

Integration Examples

curl -X POST https://api.yeb.to/v1/ebooks/epub/convert-from-file \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_url": "https://yourdomain.com/books/book.json"}'
const response = await fetch('https://api.yeb.to/v1/ebooks/epub/convert-from-file', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    file_url: 'https://yourdomain.com/books/book.json'
  })
});
const result = await response.json();
console.log(result.epub_url);
$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_API_KEY'
])->post('https://api.yeb.to/v1/ebooks/epub/convert-from-file', [
    'file_url' => 'https://yourdomain.com/books/book.json'
]);
$epub_url = $response->json()['epub_url'];
import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "file_url": "https://yourdomain.com/books/book.json"
}
r = requests.post('https://api.yeb.to/v1/ebooks/epub/convert-from-file', json=payload, headers=headers)
print(r.json()['epub_url'])

Response Examples

{
  "success": true,
  "epub_url": "https://yeb.to/storage/ebooks/epub/epub_abc123.epub",
  "epub_size": 5772,
  "template": "elegant-novel",
  "chapters": 3,
  "generated_at": "2026-02-18T14:30:00+02:00",
  "response_code": 200,
  "response_time_ms": 12
}
{
  "error": "Metadata field 'title' is required",
  "response_code": 400,
  "response_time_ms": 5
}

レスポンスコード

コード説明
200 Successリクエスト処理成功。
400 Bad Request入力バリデーション失敗。
401 UnauthorizedAPIキーが不足または不正。
403 Forbiddenキーが無効または許可されていません。
429 Rate Limitリクエストが多すぎます。
500 Server Error予期しないエラー。
EPUB 3.0 Standard

Generated EPUBs are fully compliant with the EPUB 3.0 specification:

  • Valid OPF package document with dc:metadata
  • NCX table of contents (EPUB 2 compat)
  • EPUB 3 navigation document (nav.xhtml)
  • XHTML chapters with template-based CSS
  • Embedded cover image (JPG, PNG, WebP)
  • Title page, copyright page, TOC
  • 21+ languages auto-translated
Same Input as PDF

Use the exact same JSON data for both PDF and EPUB generation. Simply switch the endpoint URL to get your preferred output format.

Convert to EPUB

ebooks/epub/convert-from-file 2.0000 credits

Parameters

API Key
body · string · required
File URL
body · string · required

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

List Templates

POST https://api.yeb.to/v1/ebooks/epub/templates
パラメータ 必須 説明
api_key string Yes Your API authentication key
Free endpoint! This endpoint costs 0 credits. Use it to discover available templates before generating.

Available Templates

Modern Novel

Clean, contemporary design. Drop-cap first letters, elegant typography.

modern-novel
Fiction, novels, short stories
Elegant Novel

Classic serif design with italic chapter titles and borders.

elegant-novel
Fiction, novels, multilingual
Academic Paper

Professional layout with bold headings and clear structure.

academic-paper
Research, academic, thesis
Business Report

Sans-serif corporate design with accent borders.

business-report
Business, reports, proposals
Cookbook

Recipe-friendly layout with warm colors.

cookbook
Recipes, cooking, food
Travel Guide

Compact sans-serif design with green accents.

travel-guide
Travel, guides, tourism
Technical Manual

Structured layout with shaded headers and monospace numbers.

technical-manual
Documentation, technical, manuals

Response Example

{
  "success": true,
  "templates": [
    {
      "slug": "modern-novel",
      "name": "Modern Novel",
      "description": "Clean, contemporary design...",
      "best_for": ["fiction", "novels", "short-stories"]
    },
    {
      "slug": "elegant-novel",
      "name": "Elegant Novel",
      "description": "Fully customizable elegant design...",
      "best_for": ["fiction", "novels", "multilingual"]
    }
  ],
  "total": 7,
  "response_code": 200,
  "response_time_ms": 8
}

レスポンスコード

コード説明
200 Successリクエスト処理成功。
400 Bad Request入力バリデーション失敗。
401 UnauthorizedAPIキーが不足または不正。
403 Forbiddenキーが無効または許可されていません。
429 Rate Limitリクエストが多すぎます。
500 Server Error予期しないエラー。

List Templates

ebooks/epub/templates 0.0000 credits

Parameters

API Key
body · string · required

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

電子書籍EPUB変換API - プロフェッショナルなEPUB 3.0生成 — Practical Guide

A hands-on guide to generating EPUB 3.0 ebooks from structured content: metadata, chapters, and templates. Same input format as the PDF API — just switch the endpoint to get reflowable EPUB output.

#What this API does

Send structured book content (metadata + chapters) and receive a valid EPUB 3.0 file with automatic table of contents, cover page, copyright page, and template-based styling. The output is reflowable — readers can adjust font size and layout on any device. Supports 21+ languages with auto-translated section headings.

Same input as PDF API. If you already use the Ebooks to PDF API, you can use the exact same JSON — just change the endpoint URL to get EPUB output instead.

#Endpoint

#POST https://api.yeb.to/v1/ebooks/epub/convert-from-file

  • Best for: Converting novels, articles, manuals, or any multi-chapter content into EPUB ebooks.
  • How it works: Pure PHP generation via ZipArchive — no external tools needed. XHTML chapters, OPF metadata, NCX + nav.xhtml TOC.
  • Output format: Valid EPUB 3.0 with NCX fallback for EPUB 2 readers.
  • Processing time: ~5-50ms depending on chapter count and cover image download.

#Quick start

Step 1: Create a JSON file with your book data:

{
  "template": "elegant-novel",
  "metadata": {
    "title": "My Book",
    "author": "Jane Doe",
    "language": "en",
    "description": "A wonderful story.",
    "cover_image": "https://example.com/cover.jpg"
  },
  "chapters": [
    {
      "title": "Chapter 1",
      "subtitle": "The Beginning",
      "content": "It was a dark and stormy night...\n\nThe wind howled through the trees."
    },
    {
      "title": "Chapter 2",
      "content": "The next morning brought sunshine and hope."
    }
  ]
}

Step 2: Upload to your server and call the API:

curl -X POST https://api.yeb.to/v1/ebooks/epub/convert-from-file \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_url": "https://yourdomain.com/book.json"}'

Step 3: Download the EPUB from the returned URL:

{
  "success": true,
  "epub_url": "https://yeb.to/storage/ebooks/epub/epub_abc123.epub",
  "epub_size": 5772,
  "template": "elegant-novel",
  "chapters": 2
}

#Available templates

TemplateStyleBest for
modern-novelSerif, drop-cap first letters, contemporaryFiction, novels, short stories
elegant-novelPalatino serif, italic chapters, bordered headingsFiction, novels, multilingual
academic-paperTimes, bold headings, left-aligned, cleanResearch, academic, thesis
business-reportSans-serif, blue accent borders, corporateReports, proposals, white papers
cookbookSerif, warm red accents, recipe-friendlyRecipes, cooking, food
travel-guideVerdana, green accents, compactTravel guides, tourism
technical-manualSans-serif, shaded headers, monospace numbersDocumentation, manuals

#Multilingual support

Set metadata.language to a 2-letter ISO code and the EPUB will automatically use translated text for section headings:

  • Table of Contents heading (e.g., "Съдържание" for Bulgarian)
  • Chapter numbering format (e.g., "Глава {n}" for Bulgarian)
  • Copyright text (e.g., "© {year} {author}. Всички права запазени.")

Supported: en, bg, de, fr, es, it, pt, ru, uk, pl, nl, tr, ja, zh, ko, ar, cs, ro, el, sr, hr.

#Generated EPUB structure

book.epub (ZIP archive)
├── mimetype                     # "application/epub+zip" (uncompressed)
├── META-INF/
│   └── container.xml            # Points to content.opf
└── OEBPS/
    ├── content.opf              # Package document (metadata + manifest + spine)
    ├── toc.ncx                  # NCX table of contents (EPUB 2 compat)
    ├── nav.xhtml                # EPUB 3 navigation document
    ├── style.css                # Template-based stylesheet
    ├── cover.xhtml              # Cover page (if cover_image provided)
    ├── titlepage.xhtml          # Title page
    ├── copyright.xhtml          # Copyright page
    ├── chapter_001.xhtml        # Chapter 1
    ├── chapter_002.xhtml        # Chapter 2
    ├── ...
    └── images/
        └── cover.jpg            # Embedded cover image

#When to use EPUB vs PDF

FeatureEPUBPDF
Reflowable text Yes Fixed layout
Reader font control Yes No
E-ink devices (Kindle) Ideal Usable
Print-ready No Yes
Fixed page numbers No Yes
Generation speed~5-50ms~2-5 seconds
File sizeSmall (5-50KB)Larger (500KB-5MB)

よくある質問

EPUB 2リーダー向けのNCXフォールバック付きEPUB 3.0ファイルを生成します。出力はApple Books、Calibre、Kobo、Google Play Books、およびすべての主要な電子書籍リーダーと互換性があります。

はい!EPUB APIは電子書籍PDF変換APIとまったく同じJSON構造(メタデータ、チャプター、テンプレート、オプション)を受け入れます。エンドポイントURLを変更するだけでPDFの代わりにEPUBを取得できます。

7つのテンプレート:モダン小説、エレガント小説、学術論文、ビジネスレポート、料理本、旅行ガイド、テクニカルマニュアル。各テンプレートは電子書籍リーダー向けに最適化された独自のCSSスタイリングを提供します。

metadata.languageを21以上のISOコード(en、bg、de、fr、es、it、pt、ru、uk、pl、nl、tr、ja、zh、ko、ar、cs、ro、el、sr、hr)のいずれかに設定してください。セクション見出し、章番号、著作権テキストは自動的に翻訳されます。

はい。metadata.cover_imageを公開URL(JPG、PNG、WebP)に設定してください。画像がダウンロードされ、EPUBファイルにカバーページとして直接埋め込まれます。

EPUB生成1回につき2クレジットです。テンプレートエンドポイントは無料(0クレジット)です。クレジットは$10からのパッケージで購入できます。

EPUB生成は非常に高速です — 最大100チャプターの書籍で通常5〜50ミリ秒。外部ツールやコンテナは不要で、すべて純粋なPHPで構築されています。

生成されたEPUBファイルは30日間保存された後、自動的に削除されます。ファイルを速やかにダウンロードするか、独自のCDNに保存してください。

はい。エラーが発生したリクエストを含め、すべてのリクエストがクレジットを消費します。クレジットは成功・失敗に関係なくリクエスト数に紐づいています。エラーが明らかに当社のプラットフォーム側の問題による場合は、影響を受けたクレジットを復元します(現金での返金はありません)。

[email protected]までご連絡ください。フィードバックを真摯に受け止めています。バグレポートや機能リクエストが意味のあるものであれば、APIを迅速に修正・改善し、お礼として50の無料クレジットを付与します。

APIやエンドポイントによって異なります。一部のエンドポイントは外部ソースのデータを使用しており、より厳しい制限がある場合があります。また、不正利用の防止とプラットフォームの安定性維持のために制限を設けています。各エンドポイントの具体的な制限についてはドキュメントをご確認ください。

クレジットシステムで運営しています。クレジットは前払いの返金不可の単位で、API呼び出しやツールに使用します。クレジットはFIFO(古いものから順に)消費され、購入日から12か月間有効です。ダッシュボードに各購入日とその有効期限が表示されます。

はい。購入したすべてのクレジット(端数残高を含む)は購入から12か月間有効です。未使用のクレジットは有効期間終了時に自動的に期限切れとなり、永久に削除されます。期限切れのクレジットは復元や現金その他の価値への変換はできません。経過措置:2025年9月22日以前に購入したクレジットは2025年9月22日購入として扱われ、2026年9月22日に期限切れとなります(購入時により早い期限が記載されていない限り)。

はい—有効期間内で繰り越されます。未使用のクレジットは利用可能な状態のまま月ごとに繰り越され、購入後12か月で期限切れになります。

クレジットは返金不可です。必要な分だけ購入してください—後からいつでもチャージできます。プラットフォーム側のエラーで課金に失敗した場合、調査後に影響を受けたクレジットを復元する場合があります。現金での返金はありません。

料金はドルではなくクレジットで設定されています。各エンドポイントには独自のコストがあります—上記の「クレジット / リクエスト」バッジをご覧ください。常に正確な支出額がわかります。
← APIに戻る