文生图出现 ：Failed to fetch
提示：请求立即失败，可能原因：
· API 服务器不可达或地址有误，请检查 API URL 是否正确、服务是否正常运行
· API 不支持 Image API
· 接口不支持浏览器跨域请求，可使用 Docker 部署版或本地运行版并配置 API 代理解决

是什么问题？如何解决？

Failed to fetch 完整解析（你文生图 GTP API 场景专用）
一、报错整体含义
Failed to fetch = 浏览器前端发起网络请求完全无法抵达 API 服务，浏览器直接拦截 / 连接中断，配套提示给了你 3 类根因，我分场景拆解 + 分步解决。
二、3 大类报错原因（按出现概率排序）
原因 1：API 服务器不可达 / URL 地址写错（链路不通）
细分踩坑点
1.API 域名 / 路径拼写错误：少写 /v1、多空格、http/https 混用、端口漏填；
2.服务商接口宕机、维护、节点故障（中转 GTP 代理最常见）；
3.本地网络限制：国内网络无法访问境外 API、防火墙 / 杀毒拦截请求；
4.IP 未加入服务商白名单、密钥过期 / 余额 / 额度耗尽；
5.接口地址是内网本地地址（127.0.0.1），公网网页无法访问。

快速排查 & 解决
1.用 curl/postman 离线测试接口（绕开浏览器）
复制完整 API 地址 + 密钥 + 请求体，在 Postman/CMD curl 调用：
能正常出图 → 排除服务端问题，锁定是浏览器跨域；
直接超时 / 404 → 地址 / 服务器 / 网络问题。
2.核对完整 BaseURL：确认协议是 https、路径包含图像生成专属端点（/images/generations）；
3.联系 API 服务商确认：当前绘图节点是否维护、通道是否关闭；
4.关闭电脑防火墙、梯子 / 代理重新切换线路。

原因 2：该 API 通道不支持 Image 图像生成接口
细分踩坑点
1.你买的套餐仅支持对话 GPT，不含 DALL・E / 文生图绘图权限，服务商关闭了图像接口；
2.模型参数填错：传了gpt-3.5-turbo对话模型，却调用绘图接口，接口不匹配；
3.中转渠道分层限制：低价子账户禁用高清文生图、仅开放对话功能。

解决
1.查看服务商后台套餐权限，确认账号开通「图像生成 / 文生图」能力；
2.核对请求里model字段，绘图接口必须填图像专属模型（dall-e-3等）；
3.联系渠道客服开通绘图权限，或升级套餐。

原因 3：浏览器跨域 CORS 拦截（最高发！网页前端调用 API 必踩）
底层原理
浏览器同源安全策略：你的网页域名 和 API 接口域名不一致，服务端没配置允许前端跨域访问，浏览器直接掐断请求，抛出Failed to fetch。
服务商给的提示也明确说了：浏览器直连第三方 API 天生跨域，有 4 套落地解决方案（按简单到复杂排序）

方案 1：本地开发用代理（前端调试首选）
1.Vite/Webpack/Nuxt 配置开发代理，把 /api 请求转发给绘图 API，消除跨域；
2.本地开启代理后，网页请求同域名代理地址，由本地服务转发 API，绕过浏览器限制。

方案 2：后端中转服务（生产环境永久根治，推荐）
自建简易后端接口做中间转发层：
网页只请求你自己的后端服务 → 后端服务无浏览器跨域限制，去调用第三方文生图 API → 把图片结果返回前端。
优势：彻底解决跨域，还能隐藏 API 密钥，防止前端密钥泄露被盗刷额度。

方案 3：Docker 本地部署 API 服务（服务商提示方案）
把绘图 API 服务部署在本地 Docker 容器，前端网页和 API 同localhost域名，无跨域拦截，适合长期批量作图。

方案 4：让 API 服务商开启全局 CORS（不推荐）
要求服务商服务端添加响应头：
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST,OPTIONS
Access-Control-Allow-Headers: Authorization,Content-Type

缺陷：开放全部域名跨域，你的 API 密钥极易被他人盗用刷额度，安全风险高。

三、标准排查步骤（按顺序执行，快速定位）
1.离线测试 API 连通性：Postman/curl 调用接口，区分是「服务本身坏了」还是「浏览器跨域」；
Postman 正常、网页报错 = 100% 跨域问题；
Postman 也报错 = URL / 服务器 / 绘图权限问题。
2.核对接口权限：确认账号开通文生图功能，额度充足、密钥有效；
3.核对请求参数：model、size、n、prompt 无超限 / 错误；
4.跨域修复：开发用本地代理；上线必须搭建后端中转接口；
5.网络兜底：切换网络、关闭广告拦截 / 浏览器插件、无痕窗口重试。

四、适配你批量电商作图的最优落地建议
你是网页前端批量生成图片素材，优先做后端中转方案：
1.前端网页不直接对接第三方 GTP 绘图 API；
2.写极简 Node/Python 后端做转发，统一携带密钥调用接口；
3.既能解决Failed to fetch跨域报错，还能防止 API Key 暴露，避免额度被盗刷，同时统一做失败重试、额度统计。