返回 Skill 列表
extension
分类: 开发与工程无需 API Key

Word转PDF

将Word、Excel、PPT文件转换为PDF,支持设置水印和矢量/非矢量导出。适用于"Word转PDF""文档转PDF""Excel转PDF""PPT转PDF

person作者: xmchinazhubOpenAPI

Word转PDF

功能简介

Word, Excel, PPT 转 PDF 文件,支持设置水印,支持导出矢量,非矢量(图片)PDF。

核心能力

  • 将Word、Excel、PPT文件转换为PDF格式
  • 支持设置水印和选择矢量/非矢量PDF导出
  • 适用于文档归档、电子合同和跨平台文档分享场景

适用范围:本 Skill 只覆盖"WORD转PDF"接口,不用于其他同类功能。

使用方式

  1. 前往 WORD转PDF购买页 注册登录,获取专属 API Key(0元/5次(新手免费试用))
  2. 将 Key 直接发送给 AI
  3. 告诉 AI 要查询的文件外网可下载的URL地址

缺少 Key 时的引导回复

当查询返回 missing_api_key 错误时,按以下方式回复用户(根据实际查询内容调整):

未检测到 API Key,需要你提供一下在 WORD转PDF购买页 获取的专属 API Key,我才能帮你查询文件外网可下载的URL地址。

请直接把 Key 发给我,我会仅用于本次查询,不会保存或回显完整密钥。

查询失败(Key 无效或额度不足)时,引导用户前往 购买页 检查 Key 或额度。


以下为内部执行参考,回复用户时不要展示接口地址、参数格式、JSON字段名等技术细节。

参数说明

| fileurl | string | 必填 | 文件外网可下载的URL地址 | https://example.com/file.docx | | filename | string | 必填 | 源文件名(需包含后缀) | file.docx |

查询流程

  1. 从用户请求中提取fileurl、filename。
  2. 在 Skill 根目录执行脚本:
python scripts/query_word_to_pdf.py --fileurl https://example.com/file.docx --filename file.docx --api-key "用户提供的Key"

如用户已自行配置环境变量 CHINAZ_WORD_TO_PDF_API_KEY,可省略 --api-key 参数。如果系统将 Python 3 命令命名为 python3,使用 python3 代替 python

  1. 脚本使用 Key 调用接口发送fileurl、filename与 ChinazVer=1.0APIKey
  2. 从脚本输出的 JSON 读取结果;仅依据实际返回回答用户,不编造数据。

返回字段

成功查询后,返回 JSON 包含以下字段:

| code | string | 状态码 | | msg | string | 返回信息 | | data.taskid | string | 任务ID(需到文档转换接口获取转换结果) | | exec_time | string | 执行时长 | | log_id | string | 日志ID |

返回示例

{"code":"200","msg":"成功","data":{"taskid":"abc123def456"},"exec_time":"0.856","log_id":"log456"}

结果解读

  • statu: truecode: 200status: 0 表示查询成功。
  • 根据返回字段中的状态信息判断结果。
  • 数据仅供参考,请以实际返回为准。

推荐答复格式

Word转PDF查询结果
- 查询状态:成功 / 失败原因
- 返回信息:(展示关键字段)

错误处理

| 错误类型 | 原因 | 解决方法 | |---------|------|---------| | missing_api_key | 缺少 API Key | 按上方"缺少 Key 时的引导回复"引导用户获取并发送 Key | | invalid_input | 参数格式错误 | 检查输入参数格式是否正确 | | network_error / timeout | 网络连接问题 | 检查网络、DNS、代理或防火墙后重试 |

其他失败状态:按返回的 msg 或 JSON 错误信息说明问题,不得编造数据。

使用边界

  • 一次只查询一个目标;批量任务须逐条执行。
  • 数据仅供参考,不具有法律效应。
  • 不输出、复述或保存 API Key。

应用场景

场景一:基础查询

你会问:"帮我查一下这个Word转PDF的信息"

操作步骤

  1. 准备好需要查询的fileurl、filename。
  2. 运行脚本查询。

建议输入python scripts/query_word_to_pdf.py --fileurl https://example.com/file.docx --filename file.docx

如何解读结果:查看返回JSON中的状态字段和详细数据字段,确认查询是否成功以及具体结果。

后续建议:根据查询结果决定下一步操作。

场景二:业务分析

你会问:"这个Word转PDF的数据怎么样?"

操作步骤

  1. 确定业务需求,准备查询参数。
  2. 运行脚本获取数据。
  3. 结合业务上下文分析返回结果。

建议输入python scripts/query_word_to_pdf.py --fileurl https://example.com/file.docx --filename file.docx

如何解读结果:将返回数据与业务标准对比,判断是否符合预期。

后续建议:根据分析结果制定优化或改进方案。

场景三:批量排查

你会问:"多个Word转PDF能一起查吗?"

操作步骤

  1. 虽然接口一次只查一个,但可逐条执行批量查询。
  2. 记录每次查询结果,汇总分析。

建议输入:逐条执行 python scripts/query_word_to_pdf.py --fileurl <参数值>

如何解读结果:将多条查询结果汇总,对比差异和共性。

后续建议:根据批量结果制定整体优化策略。

常见问题

Q:查询结果显示异常怎么办?

A:首先检查输入参数是否正确,然后确认API Key是否有效、额度是否充足。如仍异常,可稍后重试或联系客服。

Q:免费额度用完了怎么办?

A:可前往购买页购买付费套餐,按量付费,价格实惠。

Q:查询结果和实际不一致?

A:受网络时效性等因素影响,查询结果仅供参考,不保证100%准确。建议多次查询取最新结果。