Article

同一张衣服在 FASHN 网页正常,换 API 后不同,先改提示还是查输入?

按 FASHN Web 预处理与 API 实际源图差异排查商品结果,保留原图、上传衍生图和端点条件,避免为匹配输出清晰度盲目缩图。

原创方法示意:保留原图和实际提交的版本;核端点限制与图片访问方式;固定输入后再调查其他差异。非工具界面、商品实拍或测试结果。

先核对API真正收到的图片和端点条件,再决定是否改提示。FASHN故障文档说明,Web会在发送API前预处理图片,外部流程没有同样处理时可能产生不同结果。但当前预处理指南没有公布可逐步复制的完整Web流水线,不能据此承诺“照做就完全一致”。故障说明

关键要点

先取回三份真实记录

建议保留批准原图、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 辅助研究与编辑。文中的建议方法与假设练习不代表已完成实机、实拍或投放测试。软件入口与适用条件以当前官方说明和实际账户为准。了解编辑主体或联系勘误。