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;动态规格以官方说明为准。
提交前的四项检查
- 地址以
https://开头,不是本地路径、网页详情页或需要登录的私有页面; - 从无登录、无 Cookie 的环境访问仍能取得图片;
- 响应内容确实是图片,而不是 HTML 登录页、风控页或错误页;
- 签名链接的有效期足以覆盖排队、处理和必要的重试时间。
编辑任务使用 POST /images/generations,mode 设为 edit,并同时提供 model、不少于 3 个非空白字符的 prompt 和 image_urls。count 固定为 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、签名已过期、发生拦截或返回的不是图片内容。应从无登录环境重新验证。