百度智能文档分析平台 API 技能

百度智能文档分析平台提供多种文档处理能力，包括文档抽取、文档解析、文档比对、合同审查、文档格式转换等功能。

功能概览

⚠️ 安全说明

凭证配置

所有API调用需要百度API凭证（API Key 和 Secret Key）：

方式1：环境变量（推荐）

export BAIDU_DOC_AI_API_KEY="您的API_KEY"
export BAIDU_DOC_AI_SECRET_KEY="您的SECRET_KEY"

方式2：配置文件

# 创建 ~/.baidu_doc_ai_config
[credentials]
api_key = 您的API_KEY
secret_key = 您的SECRET_KEY

网络安全

• 此技能仅与百度官方API通信：aip.baidubce.com
• 不与任何第三方服务器通信

API调用模式

异步API

所有API均为异步接口，需要两步操作：

1. 提交请求 - 获取 taskId/task_id
2. 轮询结果 - 根据 taskId 查询处理结果

建议轮询时间：

• 文档抽取：5秒后开始轮询
• 文档解析：5-10秒后开始轮询
• 合同审查：1-2分钟后开始轮询
• 文档比对：5-10秒后开始轮询

使用脚本

技能提供了Python脚本，简化API调用：

统一命令行工具

所有功能集成在一个脚本中：

# 文档抽取
python scripts/baidu_doc_cli.py extract \
  --file document.pdf \
  --fields '[{"key": "合同名称"}, {"key": "合同金额"}]'

# 文档解析
python scripts/baidu_doc_cli.py parse --file document.pdf

# 文档解析VL
python scripts/baidu_doc_cli.py parse-vl \
  --file document.pdf \
  --analysis-chart --merge-tables

# 文档比对
python scripts/baidu_doc_cli.py compare \
  --base-file doc1.pdf \
  --compare-file doc2.pdf

# 合同审查
python scripts/baidu_doc_cli.py contract-review \
  --file contract.pdf \
  --template Sales_PartyA_V2

# 格式转换
python scripts/baidu_doc_cli.py convert --file document.pdf

Python API

from scripts.baidu_api_client import BaiduDocAIClient

# 初始化客户端
client = BaiduDocAIClient()

# 文档抽取
result = client.extract(
    file_data=file_data,
    manifest=[{"key": "合同名称"}, {"key": "合同金额"}]
)

# 文档解析
result = client.parse(
    file_data=file_data,
    file_name="document.pdf"
)

# 合同审查
result = client.contract_review(
    file_data=file_data,
    template_name="Sales_PartyA_V2"
)

合同类型模板

合同审查支持的合同类型：

完整模板列表见：references/contract_review.md

错误处理

常见错误码及处理方式：

配额和限制

参考文档

详细的API文档请参考 references/ 目录：

• doc_extract.md - 文档抽取API详细文档
• doc_parse.md - 文档解析API详细文档
• doc_parse_vl.md - 文档解析(PaddleOCR-VL)API详细文档
• doc_compare.md - 文档比对API详细文档
• contract_review.md - 合同审查API详细文档
• doc_convert.md - 文档格式转换API详细文档

相关链接

• 智能文档分析平台控制台
• API文档