版本说明
v1.3.0(旧版)— 单图支持
- 发布时间:原始版本
- 特点:单元格只返回第一个图片
- 字段:
image_data(单对象) - 支持状态:✅ 长期支持(不计划下线)
v1.3.1(新版)— 多图支持
- 发布时间:2026-06-03
- 特点:单元格支持返回多个图片
- 字段:
image_datas(数组) - 支持状态:✅ 推荐使用
重点:两个版本会长期共存,你可以根据业务需要选择。
如何选择版本
使用 v1.3.1(推荐)
如果你需要:- ✅ 在一个单元格中获取多张图片
- ✅ 获取最新的特性和改进
- ✅ 享受更好的向前兼容性
保持使用 v1.3.0
如果你:- ✅ 现有系统只需要单元格中的第一张图片
- ✅ 暂时不想修改代码
- ✅ 需要确保返回格式向后兼容
版本对比
Schema 结构变化
具体示例对比
- v1.3.0 响应
- v1.3.1 响应
关键差异
迁移步骤
1. 检查当前版本
查看你的代码中如何访问图片数据:2. 保留在 v1.3.0
修改 API 请求,添加schema_version 参数:
3. 更新数据处理代码
- 迁移前(v1.3.0)
- 迁移后(v1.3.1)
4. 测试验证
- ☐ 使用包含多个图片的测试表格验证
- ☐ 确认能获取到所有图片 URL
- ☐ 检查无图片单元格的处理逻辑
- ☐ 运行现有测试套件确保兼容性
代码示例
Python
JavaScript
常见问题
Q: 默认使用哪个版本?
Q: 默认使用哪个版本?
A: 如果不指定
schema_version,API 默认返回 v1.3.1(最新版本)。Q: v1.3.0 什么时候会下线?
Q: v1.3.0 什么时候会下线?
A: 暂时不计划下线 v1.3.0,我们会长期支持两个版本。如有变化会提前通知。
Q: 同一个请求中能混用两个版本吗?
Q: 同一个请求中能混用两个版本吗?
A: 不能。一个 API 请求只能指定一个
schema_version,整个响应都遵循该版本的格式。Q: 如何处理无图片的单元格?
Q: 如何处理无图片的单元格?
v1.3.0v1.3.1
Q: 旧版本的响应格式会改变吗?
Q: 旧版本的响应格式会改变吗?
A: 不会。指定
schema_version=1.3.0 的请求永远返回 v1.3.0 格式,保证向后兼容。Q: 如何验证我收到的是哪个版本的数据?
Q: 如何验证我收到的是哪个版本的数据?
A: 通过检查单元格中是否存在
image_data 或 image_datas 字段:- 有
image_data(Object)→ v1.3.0 - 有
image_datas(Array)→ v1.3.1
Q: 无效的 schema_version 会发生什么?
Q: 无效的 schema_version 会发生什么?
A: 返回 400 Bad Request 错误,错误信息会说明支持的版本列表。
迁移时间表
相关链接
快速入门
5 分钟完成第一次文档解析
解析配置详解
了解如何配置 schema_version 参数
返回结构详解
完整的返回数据结构说明
API 参考
完整的 API 参数与响应 Schema
支持与反馈
遇到问题或需要帮助?- 📧 技术支持:support@textin.com
- 🐛 问题反馈:GitHub Issues

