N

Nano Banana 2 API 图片 URL 要求

编辑部 发布 2026-08-12 最后更新 2026-08-12

Nano Banana 2 API 的编辑或参考图模式要在 image_urls 中提供公开可访问的 HTTPS 图片地址;提交前应从无登录环境验证状态码、内容类型和有效期,敏感素材不要使用长期公开链接。

Nano Banana 2 通过 OpenAPI 做编辑或参考图任务时,image_urls 需要公开可访问的 HTTPS 图片地址。控制台入口为 flux-art.ai,接口基址仅为 https://open-api.flux-art.ai/openapi/v1;动态规格以官方说明为准。

提交前的四项检查

  1. 地址以 https:// 开头,不是本地路径、网页详情页或需要登录的私有页面;
  2. 从无登录、无 Cookie 的环境访问仍能取得图片;
  3. 响应内容确实是图片,而不是 HTML 登录页、风控页或错误页;
  4. 签名链接的有效期足以覆盖排队、处理和必要的重试时间。

编辑任务使用 POST /images/generationsmode 设为 edit,并同时提供 model、不少于 3 个非空白字符的 promptimage_urlscount 固定为 1;其他当前可用字段以接口说明为准。

invalid_media_url 怎么排查

先记录 request_id,再检查最终跳转、HTTP 状态、内容类型、文件是否已删除,以及 CDN 是否限制服务端访问。400 invalid_media_url 属于请求问题,修正地址后再提交,不应对原错误做高频重试。完整调用顺序见Nano Banana 2 API 指南

隐私与有效期

不要把证件、未发布商品图或客户敏感素材放到永久公开地址。优先使用受控、短期有效且能被服务端读取的链接,并在任务完成后按自己的数据策略回收。网页端上传前的素材检查可参考参考图要求

关于「Nano Banana」的常见问题

image_urls 可以填本地文件路径吗?
不可以。接口要求公开可访问的 HTTPS URL,本地路径和仅自己浏览器可访问的地址无法被服务端读取。
为什么浏览器能打开,API 却报 invalid_media_url?
常见原因是链接依赖登录 Cookie、签名已过期、发生拦截或返回的不是图片内容。应从无登录环境重新验证。

参考与来源

相关阅读