InkoraInkora

Developer API

Powerful, simple RESTful API - implement professional PDF to eBook conversion in just a few lines of code

Base URL:https://fusion-api.oomol.com/v1

Authentication

All requests require an API key in the Authorization header (format: Bearer YOUR_API_KEY)

Authorization: Bearer YOUR_API_KEY
POST/pdf-transform-markdown/submit

Submit PDF to Markdown Task

Upload PDF file URL and submit task to convert to Markdown format

Request Parameters

  • pdfURL - PDF file cloud URL (string, required, obtained from file upload API)
  • model - Conversion model (string, required, fixed value: "gundam")
  • filename - Output file name without extension (optional), used for easier file recognition
  • ignore_pdf_errors - Ignore PDF parsing errors (optional, default: true)
  • ignore_ocr_errors - Ignore OCR errors (optional, default: true)

Request Example

{
  "pdfURL": "cache://abc123.pdf",
  "model": "gundam",
  "filename": "my-document",
  "ignore_pdf_errors": true,
  "ignore_ocr_errors": true
}

Response Example

{
  "success": true,
  "sessionID": "019aa097-f28d-7000-8d56-6a2987a7b144"
}
GET/pdf-transform-markdown/result/:taskId

Query PDF to Markdown Result

Query conversion task status and result by task ID

URL Parameters

  • taskId - Task ID (sessionID returned from submit API)

Response Example (Processing)

{
  "success": true,
  "state": "processing",
  "progress": 66
}

Response Example (Completed)

{
  "success": true,
  "state": "completed",
  "progress": 100,
  "data": {
    "downloadURL": "https://cdn.oomol.com/result.md"
  }
}

Response Example (Failed)

{
  "success": false,
  "state": "failed",
  "progress": 0,
  "error": "Conversion failure reason"
}
POST/pdf-transform-epub/submit

Submit PDF to EPUB Task

Upload PDF file URL and submit task to convert to EPUB format

Request Parameters

  • pdfURL - PDF file cloud URL (string, required, obtained from file upload API)
  • model - Conversion model (string, required, fixed value: "gundam")
  • filename - Output file name without extension (optional), used for easier file recognition
  • ignore_pdf_errors - Ignore PDF parsing errors (optional, default: true)
  • ignore_ocr_errors - Ignore OCR errors (optional, default: true)

Request Example

{
  "pdfURL": "cache://abc123.pdf",
  "model": "gundam",
  "filename": "my-document",
  "ignore_pdf_errors": true,
  "ignore_ocr_errors": true
}

Response Example

{
  "success": true,
  "sessionID": "019aa097-f28d-7000-8d56-6a2987a7b144"
}
GET/pdf-transform-epub/result/:taskId

Query PDF to EPUB Result

Query conversion task status and result by task ID

URL Parameters

  • taskId - Task ID (sessionID returned from submit API)

Response Example (Processing)

{
  "success": true,
  "state": "processing",
  "progress": 66
}

Response Example (Completed)

{
  "success": true,
  "state": "completed",
  "progress": 100,
  "data": {
    "downloadURL": "https://cdn.oomol.com/result.epub"
  }
}

Response Example (Failed)

{
  "success": false,
  "state": "failed",
  "progress": 0,
  "error": "Conversion failure reason"
}