Failed to fetch

TypeError: Failed to fetch

Firefox 里写作 NetworkError when attempting to fetch resource，Safari 里写作 Load failed。

这是浏览器里运行的工具（网页版客户端、浏览器插件、在线生图页面）没有拿到服务器回复时的统一提示，本身不说明原因。常见的是网络或代理断开、地址填错，以及请求太大：xxapi 一次请求最多收 64 MB，超过时浏览器里往往也只显示 Failed to fetch。

出现在什么时候

• 一直都报：多半是网络、代理或地址的问题。
• 平时正常，只有带大图、很多张图或很长的对话时报：多半是请求超过了 64 MB。
• 偶尔报一次：网络临时中断或代理掐断了连接。

原因

浏览器发出请求后，下面这些情况都只会给出 Failed to fetch（见 MDN 的 fetch() 说明，网络错误时抛出 TypeError）：

1. 网络或代理断开：请求没发出去，或者半路被代理、VPN 掐断。
2. 地址不对：填成了 http://、多了或少了 /v1、拼错了域名。
3. 请求太大：服务器在读完之前就拒收（HTTP 413）。这类拒收的回复里没有允许网页读取的跨域信息，浏览器拿不到状态码，只能报 Failed to fetch。图片在请求里通常是 base64 编码，体积会比原文件大约三分之一，所以几张 4K 原图、或者带着很多图片的长对话，就可能超过 64 MB。

桌面软件和命令行工具不受浏览器限制，同样的情况会直接显示 413 Request Entity Too Large 这类报错。

怎么解决

1. 先确认网络：在同一个浏览器里打开 https://xxapi.ai。打不开，就检查网络和代理；开了代理的话，试着关掉或换一个节点。
2. 核对地址：按你用的工具对应的教程填写，常见的是 https://xxapi.ai 或 https://xxapi.ai/v1，见 常见问题 里的地址对照表。
3. 请求太大时把图片和对话变小：
   • 上传前把图片缩小（例如长边 2048 像素以内）或转成 JPG、WebP；
   • 一次少带几张图；
   • 带图的长对话，每一轮都会把之前的图再发一遍，新开对话可以一下子变小。
4. 看清到底是哪种：按 F12 打开浏览器开发者工具，切到 网络（Network），再发一次。这条请求显示 413，就是太大；显示 failed、CORS 或一直没有响应，就是网络或地址问题。

用 xxapi 时还要查什么

• 64 MB 是 xxapi 每次请求的上限，按请求内容（包括 base64 图片和全部历史消息）算，和账号、分组无关。
• 只有一个工具报错，别的工具正常：检查这个工具的地址和代理设置。
• 网络、地址都正常，请求也不大，仍然报：记下出错时间、工具名称和浏览器，发给 support@xxapi.ai。截图里不要露出 API 密钥。

核对日期：2026-10-28（xxapi 请求上限 64 MB）。

回到常见问题