Article
同一张衣服在 FASHN 网页正常,换 API 后不同,先改提示还是查输入?
按 FASHN Web 预处理与 API 实际源图差异排查商品结果,保留原图、上传衍生图和端点条件,避免为匹配输出清晰度盲目缩图。

先核对API真正收到的图片和端点条件,再决定是否改提示。FASHN故障文档说明,Web会在发送API前预处理图片,外部流程没有同样处理时可能产生不同结果。但当前预处理指南没有公布可逐步复制的完整Web流水线,不能据此承诺“照做就完全一致”。故障说明
关键要点
- 同文件名不等于同一张实际输入,先找上传链上的缩图或重压缩版本。
- 输出1K或2K不是通用输入上限,不必为了匹配输出而先缩源图。
- 输入核对只消除一类差异,不能保证网页和API结果逐像素复现。
先取回三份真实记录
建议保留批准原图、API实际提交来源、对应的端点与参数。若程序先经CDN缩图再发送,只比较电脑里的原图与网页预览,无法确认API收到什么。
记录衣服款式、照片宽高、格式、是否裁切或压缩,以及使用URL还是base64。若不能取得实际提交文件或访问记录,就将输入相同标为未确认,不直接指责提示或模型。
这与Studio提示助理和API文本的区别是两种诊断:一项检查文字实际提交了什么,本题检查图片如何进入请求。它们都不能单独证明其他条件一致。
按当前预处理指南保留有用信息
官方预处理建议优先保留原始格式与质量,避免无必要转换或重压缩;只有端点限制要求,或有意缩小上传时再改尺寸。输入限制应看所用端点的Technical limitations。
| 当前做法 | 首先检查 | 合理下一步 |
|---|---|---|
| 因输出1K而把大源图缩到很小 | 是否真有该端点输入上限 | 无限制依据时,先评估保留原源图 |
| CDN自动转格式或重压缩 | 实际返回图是否丢标签/边缘 | 用可追溯来源对照,不只比URL名字 |
| 大图全部转base64后报错 | 请求体积与端点约束 | 评估合适URL方式和实际限制 |
| 网页与API输出仍有差异 | 输入、端点、设置是否已确认 | 保留未知,继续逐项调查 |
必要缩图时保持比例并用高质量下采样。官方没有要求统一裁成某个尺寸,也没有说明去底是所有端点必需的预处理,不能补出这些通用步骤。
大图访问方式也可能造成输入失败
官方建议大图优先使用稳定、可直接返回图片的HTTPS URL,不要求自定义授权头。签名URL可以用,但有效期应持续到任务完成。它是可访问性条件,不能由浏览器登录后能打开来代替验证。
故障页将过大的base64请求体列为部分500错误的可能原因,不是所有500都能这样归因。应保留报错和请求范围,让负责方核查;不要把服务器错误自动判成商品照片质量差。
源图边缘如果在缩图时已经丢失,可以参考缩图与去底顺序的细节检查理解信息损失,具体输入上限仍以FASHN端点为准。
假设练习:同名衬衫照片其实走了两条路线
假设网页上传原始衬衫照片,API却收到店铺缩略图URL;两份文件都叫shirt-blue,但缩略图已压缩,细条纹更模糊。
此时先修正来源记录,核端点是否接受原图,再用已确认输入继续评估。不要先连续修改花纹提示,否则图片和文字同时变了,后续难以判断差异来自哪里。即便统一源图,仍应比较实际条纹、纽扣和领口,不宣布已经复现网页结果。本例未调用API。
结果能否支持商品事实,可按商品图片证据用途另审。最终交付留下原始版本、实际提交版本、端点条件和剩余未知。本文依据截至2026年10月31日公开资料,没有复制未公开流水线或进行跨入口实测。
本文由 Itemlume 编辑团队依据截至2026年10月31日核对的公开资料整理,采用 AI 辅助研究与编辑。文中的建议方法与假设练习不代表已完成实机、实拍或投放测试。软件入口与适用条件以当前官方说明和实际账户为准。了解编辑主体或联系勘误。