Skip to main content

​
简要回答

上传给 API 的图片 URL 末尾带了 ?x-oss-process=... 这类云存储处理参数，会触发 image content does not match MIME type 报错。 解决办法是去掉 URL 末尾的处理参数、使用原始直链传给 API，或者先把图在自己服务端处理好再上传。

​
这个报错是什么样？

报错内容如下：
常见的触发 URL 形如：
这种 URL 末尾的 ?x-oss-process=... 是阿里云 OSS 等对象存储的图片处理参数；目前已知带上这类参数后，图片生成类接口会报上述错误。

​
已知受影响的参数名

以下参数名出现在图片 URL 末尾时，已被反馈会触发该报错：
  • x-oss-process
若你使用其他云存储的图片处理参数（例如腾讯云 COS、华为云 OBS 等的等效参数），同样建议按以下步骤处理后再传入 API。

​
解决步骤

1

去掉 URL 末尾的处理参数

复制图片的原始直链（不带 ?x-oss-process= 这类参数），重新传入 API。例如把：
改成：
2

如果需要尺寸调整，先在服务端处理后再上传

如果你的业务确实需要 OSS 端做压缩或裁剪，先在服务端把处理后的图片下载到本地，再用本地路径或新的直链（不带参数）传给 API。

​
注意事项

传进 API 的图片 URL 应尽量保持「直链、零参数」，避免触发该报错。

​
仍然无法解决时

  • 确认你传入的 URL 在浏览器中可以直接打开，且浏览器右键 → 查看图片时显示的真实格式与 URL 后缀（jpg / png / webp）一致
  • 如果使用其他云存储的图片处理参数，请联系技术支持附上具体报错 JSON 与请求 ID

​
相关文档