一、概述
我们在 5 月 18-19 日集中完成了一轮 API 兼容性优化。核心内容是修复了两个影响图片识别的问题，同时对 API 响应格式做了全面的规范性提升——字段补齐、ID 格式对齐、序列化顺序修正等，让各类客户端的对接体验更加顺畅。
对你的影响：如果你之前遇到过图片发了但模型"看不到"的情况，现在已经修复。其他改动主要是格式层面的规范化，不影响日常使用，但会让某些严格校验的工具和 SDK 表现更好。
二、图片识别修复
这是本轮改造中最核心的内容。我们发现并快速修复了两个导致模型"看不到图片"的问题，涉及两个不同的使用场景：
场景一：API 调用中使用链接类型图片
当你在 API 请求中通过 URL 链接传入图片（而不是 base64 编码）时，之前模型会回复"我无法通过 URL 访问或加载外部图片"。
API 请求中传入图片 URL → 模型无法识别，提示无法访问外部图片
API 请求中传入图片 URL → 平台自动下载并转换，模型正常识别和描述图片内容
场景二：Claude Code 中通过 @ 引用图片文件
在 Claude Code 中使用 @image.png 引用本地图片时，图片会经由工具调用的结果传回。之前这个环节的图片数据没有被正确提取，导致模型说"看不到图片"。
通过 @image.png 引用图片 → 模型回复"看不到图片"
通过 @image.png 引用图片 → 和直接粘贴图片效果一致，模型正常识别
现在，不管你是直接粘贴图片、在 API 中传入图片链接、还是在 Claude Code 里用 @ 引用图片文件——三种方式都能正常工作。
三、格式规范性提升
除了图片修复之外，我们还对 API 响应格式做了一轮全面的规范化，使其更贴近官方 API 的行为。这些改动不影响日常使用，但对于使用严格校验的 SDK 或开发自己应用的用户，体验会更顺畅。
主要涉及以下几个方面：
- 响应字段补齐 — 补充了部分客户端期望存在的字段，减少校验报错
- ID 格式对齐 — 消息 ID、工具调用 ID 等格式与官方保持一致
- 纯文本文档支持 — 新增对 document 类型内容块的处理
- 其他细节修正 — JSON 字段顺序、元数据字段等
这些格式层面的改动不会改变模型的输出内容或质量，只是让 API 的"外观"更加规范。如果你之前使用一切正常，这些改动对你没有任何影响。
四、当前兼容性现状
已完整支持
| 功能 | 状态 | 说明 |
|---|---|---|
| Messages API（流式 / 非流式） | 支持 | 完整的消息接口 |
| 图片 — base64 格式 | 支持 | 直接粘贴图片 |
| 图片 — URL 格式 | 新增 | 网络图片链接自动下载转换 |
| 纯文本文档 | 新增 | document 类型内容块 |
| 工具调用 / 工具结果 | 支持 | tool_use / tool_result 完整支持 |
| 深度思考（Extended Thinking） | 支持 | 思考过程可见 |
| 网页搜索工具 | 支持 | WebSearch 工具集成 |
| 官方响应格式 | 新增 | 全字段对齐官方 API spec |
暂不支持
| 功能 | 状态 | 原因 |
|---|---|---|
| PDF 文档 | 不支持 | Kiro 官方暂无 PDF 处理能力 |
| Files API | 不支持 | 需自建文件存储系统 |
| Prompt Caching 控制 | 不支持 | Kiro 官方暂不支持缓存指令 |
| 代码执行工具 | 不支持 | 需沙箱基础设施 |
| 批量消息接口 | 不支持 | 架构差异较大 |
关于不支持的功能：这些限制来自 Kiro 官方平台，不是我们的平台限制。一旦官方支持，我们会第一时间跟进。对于大部分日常使用场景（对话、编程、图片识别、工具调用），当前的功能覆盖已经完整。
五、常见问题
不会。所有改动都是向后兼容的——原来能用的功能不受影响，你不需要做任何配置修改。
没有。本轮改动都是轻量操作，不引入额外延迟。
不需要。你照常使用即可，之前遇到的图片识别问题会自动消失。
这取决于 Kiro 官方的支持进度。一旦官方提供 PDF 处理能力，我们会第一时间跟进适配。目前的替代方案是先将 PDF 转为文本再发送。