API 文档

将 E-Ink 电子书转换服务集成到您的应用中

通过 AI Agent 使用 — 零配置

复制下方指令，粘贴到 Cursor、Claude Code、Codex 或任何 AI 编程助手中，即可自动安装。

帮我安装 E-Ink skill：运行 npx e-ink-skill，然后把环境变量 EINK_API_KEY 设置为我的 API key。

支持 Cursor、Claude Code、Windsurf、Codex 等主流 AI 编程工具。

更多安装方式

快速开始

要使用 E-Ink API，您需要一个 API 密钥。请在控制面板中创建，然后在请求的 Authorization 头中包含该密钥。

认证方式

所有 API 请求必须在 Authorization 头中包含您的 API 密钥：

Authorization: Bearer eink_your_api_key_here

Base URL

https://e-ink.me/api/v1

积分系统

API 调用与网页端使用相同的积分系统。

API	积分消耗
网页转电子书	3(每个 URL)
文件格式转换	2 / 5(PDF OCR: 5)
电子书翻译	3(每个文件)
文字转语音	5(每个文件)
思维导图生成	2 / 5(AI: 5)

API 接口

GET/api/v1/credits

查询积分余额

返回当前积分余额。

0 credits

curl

curl https://e-ink.me/api/v1/credits \
  -H "Authorization: Bearer eink_your_api_key"

Response

{
  "credits": 150
}

POST/api/v1/convert/webpage

网页转电子书

将一个或多个网页转换为 EPUB、PDF 或 Markdown 格式。

3 credits 每个 URL

curl

curl -X POST https://e-ink.me/api/v1/convert/webpage \
  -H "Authorization: Bearer eink_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://e-ink.me", "format": "epub"}' \
  -o article.epub

POST/api/v1/convert

文件格式转换

在 EPUB、PDF、Markdown、HTML、DOCX、TXT 等格式之间转换文件。发送包含文件和转换器 ID 的 multipart 表单。

2 / 5 credits

curl

curl -X POST https://e-ink.me/api/v1/convert \
  -H "Authorization: Bearer eink_your_api_key" \
  -F "file=@book.epub" \
  -F "converter=epub-to-pdf" \
  -o book.pdf

POST/api/v1/convert/translate

电子书翻译

将 EPUB 文件翻译为其他语言。发送包含 EPUB 文件、目标语言和可选源语言的 multipart 表单。

3 credits 每个文件

curl

curl -X POST https://e-ink.me/api/v1/convert/translate \
  -H "Authorization: Bearer eink_your_api_key" \
  -F "file=@book.epub" \
  -F "targetLanguage=Chinese" \
  -F "sourceLanguage=auto" \
  -o book-translated.epub

POST/api/v1/convert/tts

文字转语音

将文字转换为语音音频（MP3 格式）。

5 credits 每个文件

curl

curl -X POST https://e-ink.me/api/v1/convert/tts \
  -H "Authorization: Bearer eink_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"input": "Hello, this is a test.", "voice": "en-US-JennyNeural"}' \
  -o speech.mp3

POST/api/v1/convert/mindmap

思维导图生成

从 EPUB 或 PDF 文件生成思维导图。发送包含文件、模式和导出格式的 multipart 表单。

2 / 5 credits

curl

curl -X POST https://e-ink.me/api/v1/convert/mindmap \
  -H "Authorization: Bearer eink_your_api_key" \
  -F "file=@book.epub" \
  -F "mode=structure" \
  -F "format=freemind"

Response

{
  "tree": { "label": "Book Title", "children": [...] },
  "stats": { "nodeCount": 42, "maxDepth": 4 },
  "files": {
    "freemind": "<map>...</map>",
    "opml": "<?xml ...?>...",
    "markdown": "# Book Title\n## Chapter 1\n..."
  }
}

错误码

Code	Description
400	Bad Request — 参数无效
401	Unauthorized — API 密钥缺失或无效
402	Payment Required — 积分不足
413	Payload Too Large — 文件超过大小限制
500	Internal Server Error — 服务器内部错误

AI Agent Skill

通过 Agent Skill 在 Cursor、Claude Code、Codex 等 AI 编程工具中直接使用 E-Ink。转换网页、翻译电子书等，一切在编辑器中完成。

安装方式

直接告诉 AI