PDF文档转换(apiCode=3275)指南总目录
pdf-doc-convert-guides-3275 # PDF文档转换(apiCode=3275)指南总目录
> 接口:PDF文档转换 · apiCode=3275 · 官方自营
> 本文档是 [showapi.com](https://www.showapi.com) 上该接口的全部指南入口,按阅读顺序排列。
---
## 接口速览
**PDF文档转换**(showapi PDF文档转换接口,apiCode=3275)提供 PDF 解析能力,可识别文本、表格、公式、图片等元素,保留排版逻辑,输出 Markdown(`.md`)或 Word(`.docx`)格式。适用于知识库构建、金融报告分析、学术论文转换等场景。
- **接入点**:3 个(`3275-1` 文件上传 / `3275-2` 结果获取 / `3275-3` 历史记录查询)
- **工作模式**:异步两步走(上传 → 轮询 → 下载结果文件)
- **计费**:按实际页数计费,专用资源包 ¥9.90/12个月起;支持通用资源包
- **限制**:单文件不超过 100MB;结果下载链接实效 7 天
- **集成**:MCP 配置 · OpenAPI 3.0 YAML+JSON
---
## 文章列表
| # | 标题 | slug | 一句话简介 |
|---|------|------|-----------|
| — | [PDF文档转换:5分钟完成异步上传与结果下载](https://www.showapi.com/guides/pdf-doc-convert-quickstart-3275) | `pdf-doc-convert-quickstart-3275` | 入门必读,从注册到拿到第一个转换结果的完整流程,附 Python / cURL / Node.js 代码 |
| — | [PDF文档转换返回字段全解:state 状态机与 task_id 生命周期](https://www.showapi.com/guides/pdf-doc-convert-state-machine-3275) | `pdf-doc-convert-state-machine-3275` | 异步模式下 state 枚举(preparing→processing→success/failed)的完整说明,含状态机图 |
| — | [在知识库系统里集成PDF文档转换](https://www.showapi.com/guides/pdf-doc-convert-knowledge-base-3275) | `pdf-doc-convert-knowledge-base-3275` | 从上传到 Markdown 入库的完整流程,附时序图与数据库表结构示例 |
| — | [PDF转Markdown方案怎么选:自建 OCR、付费接口与 ShowAPI 三方对比](https://www.showapi.com/guides/pdf-doc-convert-compare-3275) | `pdf-doc-convert-compare-3275` | 中立横向对比三种方案:成本、精度、上手难度,帮你判断哪个适合你 |
| — | [PDF文档转换失败怎么处理:超时、重试与7天时效下载链接管理](https://www.showapi.com/guides/pdf-doc-convert-fail-retry-3275) | `pdf-doc-convert-fail-retry-3275` | 常见失败原因排查、指数退避重试策略、download_url 时效管理实战 |
**共 5 篇正文 + 1 篇索引页。**
---
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页 | https://www.showapi.com/apiGateway/view/3275 |
| 接入点1:文件上传处理 | https://www.showapi.com/apiGateway/view/3275/1 |
| 接入点2:转换结果获取 | https://www.showapi.com/apiGateway/view/3275/2 |
| 接入点3:历史记录查询 | https://www.showapi.com/apiGateway/view/3275/3 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/3275.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/3275.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 通用资源包充值 | https://www.showapi.com/ai/llm/recharge |
| 资源包档位说明 | https://www.showapi.com/apiGateway/view/3275(页面「产品价格」区块) |
---
## 阅读建议
- **第一次接触这个接口**:从第 1 篇「快速开始」读起,跑通示例后再往下看。
- **已经能调通但状态不对**:直接跳第 2 篇,对照 state 枚举排查。
- **准备接入生产系统**:先看第 3 篇(知识库场景),再回来看第 5 篇(失败处理)。
- **还在选型阶段**:第 4 篇(选型对比)帮你判断要不要用。
---
*最后更新:2026-09-07(内容基于 ShowAPI 官方文档及浏览器实测核对)*