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

​
相關文件