Article

FASHN API Agent Images 显示成功,为什么三视角加透明图的交付包还缺文件?

按 Agent Images 返回全部中间图及部分成功的行为清点商品交付包,区分运行完成、生成步骤与各用途最终文件,处理缺项并保留已通过结果。

原创方法示意:生成前列出独立交付用途;按返回操作与实际文件清点;保留通过项并单独处理缺项。非工具界面、商品实拍或测试结果。

因为 Agent Images 的运行成功不等于你要求的每个交付都完成。官方说明,只要生成了至少一张图,即使后续步骤失败,也会返回已有图并成功;返回还包含中间步骤图片。应把实际文件逐项匹配到“三视角、透明图”等交付用途,不能只数返回数量或看 completed。Agent Images 官方说明

关键要点

请求前先把“一套”拆成可验收结果

本文仅讨论 FASHN API Agent Images,不是其网页聊天工具。截至2026年10月31日,官方将该端点标为 Experimental,发布于2026年10月26日;生命周期说明提示其行为、参数或响应结构可能变化。

建议用普通语言写明商品来源、每张图的用途和透明要求。Agent 不会反问,含糊时会根据输入自行判断。因此,“给我一套电商图”不够表达哪张要正面、哪张应去底、哪些不能改变商品。

可先在团队记录里列四项:正面场景图、侧面图、背面图、正面透明图。这是交付计划,不是保证源照片足以支持未拍到的背面。缺少真实背面证据时,应先收窄任务或补图。

按操作与用途清点,不机械计数

官方返回的 predictions 按操作顺序列出所有产生图片的步骤,包含中间图;每项有 tool、results 和 credits_used。这些是真实文档字段,但工具名称仍不能替你确认文件内容。

实际返回 应如何记录 不宜直接计入
一张正面场景图 正面候选,核商品与构图 其他角度已完成
同一正面图的去底版本 正面透明候选,另验透明和边缘 自动多出一个新视角
修订过程里的旧版本 中间图,标明采用与否 最终交付数量
计划的背面没有对应文件 缺项或未确认 用相似侧面图补账

这与工作流范例和本次输出的清点不同:本题即使所有图都来自本次运行,中间步骤仍可能让数量看起来够了。

为什么会在缺项时结束?

官方限制每次最多8个操作、15分钟。达到限制会停止并返回已做的图;到时仍在生成的任务会完成并计费,但不会返回。若一张图都没做出,才按相应错误结束。它也明确不会擅自加上未请求的放大或变体步骤。

不要把15分钟当作必须等待到的通用时限,也不要自行取消正在运行的生产任务。对于异步运行,processing期间没有部分结果;等实际终态后核返回。若缺项原因没有明确证据,记录未知,不声称一定碰到了8步限制。

假设练习:有四张图,却只有两个用途可交

假设计划三视角加一张透明图,返回了正面旧版、正面修订版、正面去底版和侧面图。四个文件不等于四项交付:正面修订版可以候选,旧版应标为未采用,透明图仍需核边缘,背面没有结果。

先审核并保留正面与侧面合格项;若背面必须依赖尚未提供的真实角度,就先补来源。若只是特定处理未完成,再由负责人决定是否单独补做,保留与原运行的对应关系,不悄悄替换已通过文件。本例未提交请求。

交付状态要落在文件上

可以采用逐SKU与用途批准的方法,把“运行完成、文件存在、内容通过、用途采用”分开记录。画面可信度再按商品图证据用途限定,不能因为API成功就用生成背面证明真实结构。

保留运行ID、实际文件、用途映射、采用版本、缺项和实际费用记录。本文为官方行为解读与人工清点建议,没有执行API或测量成套成功率。

本文由 Itemlume 编辑团队依据截至2026年10月31日核对的公开资料整理,采用 AI 辅助研究与编辑。文中的建议方法与假设练习不代表已完成实机、实拍或投放测试。软件入口与适用条件以当前官方说明和实际账户为准。了解编辑主体或联系勘误。