diff --git a/web/src/api/goauto/shopee-products.js b/web/src/api/goauto/shopee-products.js
index 0b28cbf..e15f207 100644
--- a/web/src/api/goauto/shopee-products.js
+++ b/web/src/api/goauto/shopee-products.js
@@ -52,12 +52,18 @@ export function previewShopeeAutoSizeMatches(productId) {
   return request({ url: `/api/admin/v1/shopee-products/${productId}/specs/mapping/preview-auto-size`, method: 'post' })
 }
 
+// AI 建议会同步等待一次真实的大模型调用，服务端 AI 匹配设置允许的超时最长可达 600
+// 秒（aimatching.maxTimeoutSecs）。这里的超时必须明显长于服务端上限，否则前端会先
+// 掐断连接，浏览器把这当作连接失败，弹出与真实原因无关的「服务器连接异常」。不改全局
+// axios 默认超时，只放宽这两个会触发外部调用的接口。
+const aiSuggestTimeoutMs = 610000
+
 export function suggestShopeeColorMappings(productId, data) {
-  return request({ url: `/api/admin/v1/shopee-products/${productId}/specs/mapping/suggest-colors`, method: 'post', data })
+  return request({ url: `/api/admin/v1/shopee-products/${productId}/specs/mapping/suggest-colors`, method: 'post', data, timeout: aiSuggestTimeoutMs })
 }
 
 export function suggestShopeeSizeMappings(productId, data) {
-  return request({ url: `/api/admin/v1/shopee-products/${productId}/specs/mapping/suggest-sizes`, method: 'post', data })
+  return request({ url: `/api/admin/v1/shopee-products/${productId}/specs/mapping/suggest-sizes`, method: 'post', data, timeout: aiSuggestTimeoutMs })
 }
 
 export function batchDeleteShopeeProducts(data) {