“图片格式无效”说明后端无法识别图片数据，需检查URL可访问性与Content-Type、Base64前缀及编码规范、原始格式是否在JPEG/PNG/WebP/BMP/TIFF支持列表内，并确保multipart中图片字段为text/plain类型的字符串。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎API提示“图片格式无效”，说明后端解析时无法识别你提交的图片数据——它可能根本不是合法图片，或是编码方式不满足要求，或是URL不可访问，此时400错误会直接返回，不进入鉴权与模型调度流程。
检查图片URL是否可公开访问且响应正确
打开浏览器，直接粘贴你传入的 image_url.url 字段值，回车访问。如果出现 403、404、超时或跳转到登录页，该URL即为无效源。
确保服务器返回的 HTTP 状态码是 200，且响应头中 Content-Type 明确为 image/jpeg、image/png、image/webp 等标准类型。若返回 text/html 或 application/octet-stream，即使文件名带 .png，火山引擎也会拒收。
禁止使用私有云存储的临时签名链接（如七牛、阿里OSS未设置 public-read）；若必须用，需确认签名未过期、Referer 白名单已放行、且响应头携带正确 Content-Type。
验证Base64编码是否符合规范格式
Base64 图片必须以 data:image/{format};base64, 开头，其中 {format} 小写且与实际图片格式一致（如 jpeg、png、webp），逗号后紧跟无换行、无空格的纯 Base64 字符串。
常见错误：漏掉 data:image/png;base64, 前缀，只传 Base64 字符串；或用中文逗号、全角字符分隔；或字符串末尾含 \n\r 换行符——这些都会导致解析失败并返回 400。
用 Python 快速校验：base64.b64decode(your_base64_string) 若抛出 binascii.Error: Incorrect padding，说明 Base64 编码本身非法，需重新生成。
确认图片原始格式是否被支持
第一步：用本地工具查看图片真实格式。Windows 右键→属性→详细信息→“图像类型”；macOS 打开预览→显示检查器→更多信息→“Kind”；Linux 运行 file -i your_image.jpg。
第二步：对照火山引擎文档确认支持列表——仅接受 JPEG/JPG、PNG、WebP、BMP、TIFF。GIF、SVG、HEIC、AVIF 均不支持，即使转成 Base64 也无效。
第三步：若原始格式合法但依然报错，用 convert input.gif output.png（ImageMagick）或在线工具彻底重导出，避免元数据污染。某些手机直出 PNG 实际含私有扩展块，火山引擎解析器会拒绝。
排查 multipart/form-data 中图片字段封装问题
方法一：确保图片字段值是字符串，而非 JSON 对象或二进制流。例如字段名为 input，其值应为：{"type":"image_url","image_url":{"url":"https://xxx.png"}} → 必须先 json.dumps() 成字符串再塞入 form，不能直接 append 原生 dict。
方法二：该 form 字段必须显式设置子类型头：Content-Type: text/plain。若用 axios 或 requests 未手动指定，多数库默认设为 application/octet-stream，火山引擎将因类型不匹配返回 400。
注意：multipart 中任何字段都不能嵌套 JSON 对象；所有结构化内容必须序列化为字符串并标注 text/plain。
