快速开始

本指南使用 cURL 和 PDF 转 Markdown 接口。PDF 转 EPUB 也使用相同的“提交后轮询”模式。

1. 创建 API Key

在 OOMOL Console 创建 API Key。请将它保存在服务端或密钥管理服务中，绝不要打包到浏览器代码或公开客户端应用中。

2. 提交转换任务

替换示例中的 Key 与 PDF URL，然后请求提交接口。

curl --request POST "https://fusion-api.oomol.com/v1/pdf-transform-markdown/submit" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "pdfURL": "https://example.com/guide.pdf",
    "model": "gundam"
  }'

响应中的 sessionID 就是任务 ID。建议将其与自己系统中的任务记录一同保存，并在下方替换 TASK_ID，以便追踪重试与下载。

3. 轮询结果

持续请求结果接口，直到状态为 completed 或 failed，或者达到最大尝试次数或截止时间。将所有非 2xx 响应视为错误；如果 state 未知，也应停止轮询。对耗时较长的文档，应先使用较短间隔，再逐步增加轮询间隔。

curl --request GET "https://fusion-api.oomol.com/v1/pdf-transform-markdown/result/TASK_ID" \
  --header "Authorization: Bearer YOUR_API_KEY"

通过 state 判断任务状态。状态为 completed 时，从 data.downloadURL 下载生成文件；状态为 failed 时，记录并处理返回的失败原因。

下一步

• 阅读 API 核心概念，了解认证、任务状态和重试策略。
• 需要请求和响应字段时，查阅完整 API Reference。