[Bug] 图片预处理链路未做格式归一化，导致部分 API 在多模态识别 WebP 时失败

[afafrdgegreg]

Description

在使用多模态模型（包括智谱 GLM-4.6V-Flash 和 Moonshot Kimi-K2.6）识别 WebP 格式图片时，API 返回 400 错误，错误码 1210，提示"图片输入格式/解析错误"。

Reproduction Steps

使用智谱 GLM-4.6V-Flash或agnes
向 AstrBot 发送一张 WebP 格式的图片
BOT 调用多模态模型（Kimi/智谱）识别图片
返回 400 错误，显示日志

AstrBot Version

v4.27.3

Operating System

Linux

Deployment Method

python uv

Message Platform Adapter

Onebot v11

Error Log

[2026-08-19 09:35:10.048] [Plug] [ERRO] 获取图片描述失败: Error code: 400 - {'error': {'code': '1210', 'message': '图片输入格式/解析错误'}}
[2026-08-19 09:35:13.450] [Core] [ERRO] 处理图片描述失败: Error code: 400 - {'error': {'code': '1210', 'message': '图片输入格式/解析错误'}}
[2026-08-19 09:58:22.693] [Core] [WARN] 图片格式转换失败，使用原始数据: a bytes-like object is required, not 'str'

Supplementary Information

fix.txt
123.txt

Checklist

• I have searched the Issue list for related issues and could not resolve the problem, or this issue has never been reported before.
• I have tried disabling all plugins to rule out issues caused by plugins.
• The issue I am reporting is related to AstrBot itself, not to a specific plugin.
• I have read and agree to the project's Code of Conduct.
• (Optional) I am willing to submit a PR to help fix this issue.

[dosubot]

Hi @afafrdgegreg! I'm Dosu and I'm helping the AstrBotTeam team.

根据代码分析，这个 bug 的根因比较清晰：

问题所在

MediaResolver.to_base64_data() 在处理图片时，通过 detect_image_mime_type_async() 正确检测到 MIME 为 image/webp，但随后直接将原始 WebP 字节编码为 base64 发给 API，没有做任何格式转换 [1]。智谱和 Moonshot 的 API 不接受 WebP 格式，因此返回 1210 错误。

ensure_jpeg() 函数能将 WebP 转成 JPEG，但它只在特定调用点被使用（如压缩图片路径），不会在 to_base64_data() 的图片主路径上自动执行 [2]。同样，_resolve_path() 只对 audio 类型做格式转换，对 image 类型没有任何转换逻辑 [3]。

日志中的第三条警告 "图片格式转换失败，使用原始数据: a bytes-like object is required, not 'str'" 说明某处确实尝试了格式转换但因传入 str 而非 bytes 而失败，这是一个独立的类型错误。

此外，openai_source.py 的 _handle_api_error() 目前只对 invalid_attachment、content moderation 和 non-VLM 错误做 fallback，不会捕获错误码 1210 这类格式相关的错误 [4]。

修复思路

1. 核心修改：在 to_base64_data() 的图片路径中，检测到 image/webp（以及 BMP、TIFF 等 API 不广泛支持的格式）后，调用 ensure_jpeg() 将其转为 JPEG 再编码。这是最干净的方案。

2. 可选增强：在 _handle_api_error() 中将错误码 1210（或类似格式错误码）纳入触发 WebP→JPEG 重试的条件。

3. 修复类型错误：排查调用格式转换逻辑的地方，确保传入的是 bytes 而非 str。

如果你打算提交 PR，核心修改集中在 astrbot/core/utils/media_utils.py 的 to_base64_data() 方法。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.