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