Skip to main content
为了支持单元格内输出多个图片的能力,我们升级了 Table 结构的 Schema。本指南帮助你理解版本差异,选择合适的版本,以及平滑迁移到新版本。

版本说明

v1.3.0(旧版)— 单图支持

  • 发布时间:原始版本
  • 特点:单元格只返回第一个图片
  • 字段image_data(单对象)
  • 支持状态:✅ 长期支持(不计划下线)

v1.3.1(新版)— 多图支持

  • 发布时间:2026-06-03
  • 特点:单元格支持返回多个图片
  • 字段image_datas(数组)
  • 支持状态:✅ 推荐使用
重点:两个版本会长期共存,你可以根据业务需要选择。

如何选择版本

使用 v1.3.1(推荐)

如果你需要:
  • ✅ 在一个单元格中获取多张图片
  • ✅ 获取最新的特性和改进
  • ✅ 享受更好的向前兼容性

保持使用 v1.3.0

如果你:
  • ✅ 现有系统只需要单元格中的第一张图片
  • ✅ 暂时不想修改代码
  • ✅ 需要确保返回格式向后兼容

版本对比

Schema 结构变化

具体示例对比

关键差异


迁移步骤

1. 检查当前版本

查看你的代码中如何访问图片数据:

2. 保留在 v1.3.0

修改 API 请求,添加 schema_version 参数:

3. 更新数据处理代码

4. 测试验证

  • ☐ 使用包含多个图片的测试表格验证
  • ☐ 确认能获取到所有图片 URL
  • ☐ 检查无图片单元格的处理逻辑
  • ☐ 运行现有测试套件确保兼容性

代码示例

Python

JavaScript


常见问题

A: 如果不指定 schema_version,API 默认返回 v1.3.1(最新版本)。
A: 暂时不计划下线 v1.3.0,我们会长期支持两个版本。如有变化会提前通知。
A: 不能。一个 API 请求只能指定一个 schema_version,整个响应都遵循该版本的格式。
v1.3.0
v1.3.1
A: 不会。指定 schema_version=1.3.0 的请求永远返回 v1.3.0 格式,保证向后兼容。
A: 通过检查单元格中是否存在 image_dataimage_datas 字段:
  • image_data(Object)→ v1.3.0
  • image_datas(Array)→ v1.3.1
A: 返回 400 Bad Request 错误,错误信息会说明支持的版本列表。

迁移时间表


相关链接

快速入门

5 分钟完成第一次文档解析

解析配置详解

了解如何配置 schema_version 参数

返回结构详解

完整的返回数据结构说明

API 参考

完整的 API 参数与响应 Schema

支持与反馈

遇到问题或需要帮助? 如有任何问题或遇到迁移困难,欢迎随时联系我们!