TypeSafe Python SDK 0.7.5
一篇官方 SDK 更新记录，涵盖文档重组、实验性图片与 Box 支持、资源附件和默认 zstd 请求压缩。
- 发布日期
- 2026-10-14
- 核实日期
- 2026-10-19
- 产品
- TypeSafe Python SDK
安装方式
pip install "typesafe-sdk[zstd]==0.7.5"发布背景
本页根据 TypeSafe Python SDK 0.7.5 官方发布记录整理。图片与 Box 支持仍属实验性能力，生产集成应遵循当前文档，不应把这份历史摘要当作长期不变的 API 契约。
更新重点
- 文档重新划分为 Basic 和 Advanced 两部分；这属于文档结构变化，不代表新增一项独立运行时能力。
- 实验性图片输入支持 bytes、文件路径、base64 数据和 PIL 图片。
- SDK 增加 Box 问题与回答，并提供 attach_assets，把资源附加到文本中供问题引用。
- 当运行环境具备 zstd 支持时，大于等于 1 KiB 的请求体默认使用 zstd 压缩。
安装方式
pip install "typesafe-sdk[zstd]==0.7.5"
uv add "typesafe-sdk[zstd]==0.7.5"兼容与升级检查
- 图片与 Box 接口仍属实验性能力；生产使用前应遵循当前 TypeSafe 文档，并以代表性请求运行回归测试。
- 该软件包要求 Python 3.10 或更高版本。
- Python 3.13 及更早版本需要安装 zstd extra；Python 3.14 可以使用标准库提供的 zstd 支持。
- zstd 请求压缩默认启用，非官方 API 的压缩支持可能滞后；通过其他实现发送请求前需要先核实兼容性。
- 只有使用 Pillow 的 PIL 对象输入时才需要可选的 pil extra；本页展示的默认 zstd 安装命令不会附带 pil extra。
- 仅在复现本次版本时固定使用 0.7.5；升级或依赖特定版本行为前，应查看更新后的 SDK 文档。
范围说明
本更新记录不承诺性能提升。压缩取决于请求大小、已安装或标准库提供的 zstd 支持和服务端兼容性；实验性图片与 Box 接口仍可能变化，文档拆分本身也不会增加运行时能力。