Transform API 支持将 PDF 转为 Markdown、EPUB 或翻译后的 PDF，也支持将 EPUB 翻译为 EPUB。一次转换对应一个异步任务：创建任务、上传原文件、启动处理，完成后下载结果。
获取 API Key
登录 OOMOL Console，创建 API Key。将密钥保存在服务端或本机环境中。处理会消耗账户 credits，开始前请检查余额与价格。
| 配置 | 值 |
|---|---|
| 接口地址 | https://api.pdfcraft.ai/v1/pcc-api |
| 鉴权 | Authorization: Bearer YOUR_API_KEY |
| 请求体 | JSON，文件直传除外 |
上述地址需要使用生产环境的 API Key，不能用网站 Cookie 或其他 OOMOL 服务的凭据代替。密钥仅通过 API 请求的 Authorization 头传入；上传和下载文件时无需传入。
运行 Python 示例
需要 Python 3.9 或更高版本，无需安装额外依赖。下载示例脚本：
curl --fail --show-error --location \ https://pdfcraft.ai/examples/api-quickstart.py \ --output api-quickstart.py通过环境变量传入密钥，不写进脚本。以下命令适用于 Bash 和 Zsh，输入密钥时不回显：
export PDF_CRAFT_API_KEY="$( python3 -c 'import getpass; print(getpass.getpass("API key: "))')"python3 api-quickstart.py脚本会下载我们提供的单页 PDF，上传并转换为 Markdown。任务 ID 保存在 pdf-craft-task.json 中，方便中断后继续。
脚本会定期查询状态，直到任务结束或超时。转换成功后，结果保存为 pdf-craft-result.zip。脚本还会检查 Markdown 是否包含示例 PDF 中的句子，这项检查仅适用于随附样例。
Markdown 结果是 ZIP 压缩包，并非单个 .md 文件。解压后可读取 Markdown 及其配套资源；EPUB 和 PDF 输出分别下载为对应格式的文件。
中断后继续
如果脚本超时或网络中断，但已经保存任务 ID：
python3 api-quickstart.py \ --resume pdf-craft-task.json \ --output pdf-craft-result.zip \ --timeout 1200请使用创建任务时的账户。脚本会检查任务状态，继续尚未完成的步骤；已经失败的任务无法重启。如果输出文件已存在，请换一个路径，脚本不会覆盖原文件。
如果状态文件中只有 creation_unknown，没有 uuid，说明脚本未能确认任务是否创建成功。请保留状态文件，通过等待上传列表查找任务后，再决定是否重新创建。
处理自己的文档
示例脚本使用固定的 PDF 和转换参数。处理自己的文件时，请按 cURL 分步接入操作，再选择转换与翻译参数。
集成到程序时，请保存任务的 uuid 和启动参数。如何恢复中断请求、处理过期任务，见任务生命周期。完整字段见接口参考，也可下载 OpenAPI。