CamScanner PDF 转 Office

概述

CamScanner 提供文档转换能力，可将 PDF 文档转换为 Word 或 Excel 文档，同时保留原始格式。该工作流分为三个步骤：先 上传 PDF 文件，再 转换，最后 下载 结果。

适用场景

• 用户希望将 PDF 转换为 Word（.docx）或 Excel（.xlsx）格式
• 用户希望使 PDF 可编辑
• 用户已有 PDF 文件，但需要将其转为 Office 文档格式

隐私与数据

重要提示：隐私与数据流向说明

• 第三方服务：本技能会将您的文件发送至 CamScanner 官方服务器（ai-tools.camscanner.com）进行处理。
• 数据留存：CamScanner 服务器对您的文件进行实时处理，文件不会永久保存在服务器上。
• 本地文件：输出文件将保存至您指定的本地文件系统路径。

API 参考

基础 URL： https://ai-tools.camscanner.com

支持的转换类型

步骤 1：上传 PDF

BASE="https://ai-tools.camscanner.com"

IN_FILE_ID=$(curl -sS -X POST "$BASE/v1/tools/upload_file/execute" 
  -H "Content-Type: application/octet-stream" 
  --data-binary "@/path/to/document.pdf" | jq -r '.tool_result.data.file_id')

响应示例：

{
  "code": 200,
  "tool": "upload_file",
  "tool_result": {
    "success": true,
    "data": {
      "file_id": "file_1741857600_ab12cd34ef56",
      "size": 24576
    }
  }
}

步骤 2：转换 PDF

OUT_FILE_ID=$(curl -sS -X POST "$BASE/v1/tools/convert_pdf/execute" 
  -H "Content-Type: application/json" 
  -d "{"file_id":"$IN_FILE_ID","source_type":"pdf","target_type":"TARGET","output_mode":"file_id"}" 
  | jq -r '.tool_result.data.file_id')

请将 TARGET 替换为以下值之一：word 或 excel。

响应示例：

{
  "code": 200,
  "tool": "convert_pdf",
  "tool_result": {
    "success": true,
    "data": {
      "file_id": "file_1741857722_ddeeff001122",
      "target_type": "word"
    }
  }
}

步骤 3：下载结果

curl -sS -X POST "$BASE/v1/tools/download_file/execute?response_mode=raw" 
  -H "Content-Type: application/json" 
  -d "{"file_id":"$OUT_FILE_ID"}" 
  -o /path/to/output.docx

关键说明： 必须在下载请求 URL 中包含 response_mode=raw 查询参数，才能获取二进制文件；否则响应将为 JSON 格式。

快速参考：完整流程脚本

BASE="https://ai-tools.camscanner.com"
INPUT_PDF="/path/to/document.pdf"
TARGET_TYPE="word"          # word | excel
OUTPUT_FILE="/path/to/output.docx"

# 上传
IN_FILE_ID=$(curl -sS -X POST "$BASE/v1/tools/upload_file/execute" 
  -H "Content-Type: application/octet-stream" 
  --data-binary "@$INPUT_PDF" | jq -r '.tool_result.data.file_id')

# 转换
OUT_FILE_ID=$(curl -sS -X POST "$BASE/v1/tools/convert_pdf/execute" 
  -H "Content-Type: application/json" 
  -d "{"file_id":"$IN_FILE_ID","source_type":"pdf","target_type":"$TARGET_TYPE","output_mode":"file_id"}" 
  | jq -r '.tool_result.data.file_id')

# 下载
curl -sS -X POST "$BASE/v1/tools/download_file/execute?response_mode=raw" 
  -H "Content-Type: application/json" 
  -d "{"file_id":"$OUT_FILE_ID"}" 
  -o "$OUTPUT_FILE"

文件扩展名映射

常见错误

错误处理

请在执行下一步前检查每个步骤是否成功：

# 上传后检查
if [ -z "$IN_FILE_ID" ] || [ "$IN_FILE_ID" = "null" ]; then
  echo "上传失败"; exit 1
fi

# 转换后检查
if [ -z "$OUT_FILE_ID" ] || [ "$OUT_FILE_ID" = "null" ]; then
  echo "转换失败"; exit 1
fi