Nano Banana 2 API invalid_media_url 怎么修
编辑部 发布 2026-09-02 最后更新 2026-09-02
Nano Banana 2 API 返回 invalid_media_url 时，先检查 image_urls 是否为公开可访问的 HTTPS 图片地址、是否按数组传入，以及服务端能否直接读取。该错误不应原样重试，修正媒体地址后再用新幂等键提交。
Nano Banana 2 API 在编辑或参考图模式中使用 image_urls。如果返回 400 invalid_media_url，不要把相同请求原样重试；先修正媒体地址。
五项检查清单
- 地址是否以
https://开头，而不是本地路径或内网地址； - 不带浏览器登录态时，服务端是否仍能读取图片；
image_urls是否按数组传入；- 地址是否在任务处理期间保持有效；
- 响应是否被防盗链、跳转或权限页替代。
更完整的输入要求见图片 URL 说明。如果是字段结构或长度问题，应按422 参数校验处理。
修好后如何提交
媒体地址发生变化后，这是修正后的新请求，应使用新的 Idempotency-Key。日志只保留脱敏地址、request_id 与错误码，不记录 API Key 或含敏感参数的完整 URL。
关于「Nano Banana 2 API invalid_media_url 怎么修」的常见问题
- 本地文件路径能直接放进 image_urls 吗?
- 不能。image_urls 需要公开可访问的 HTTPS 图片地址。
- 返回 invalid_media_url 后要自动重试吗?
- 不要原样重试；先修正地址或访问条件，再把它作为新请求提交。
- 带登录态或短效签名的地址可以吗?
- 要确保 OpenAPI 服务在处理期间能直接访问；有效期与访问控制由调用方自行核对。