Article

FASHN API Agent Images 参数设了竖屏4K,提示里写旧方图2K会听谁的?

排查 Agent Images 提示内画幅与输出尺寸覆盖参数的冲突,把参考图职责、最终比例和实际像素分开核对,避免沿用旧广告简报。

原创方法示意:找出提示中的旧比例和尺寸;统一当前交付要求与参数;检查真实文件及商品构图。非工具界面、商品实拍或测试结果。

先清理提示里的冲突。FASHN API Agent Images 文档明确:提示中要求的比例优先于 aspect_ratio,提示中要求的输出尺寸优先于 resolution。因此,参数设9:16和4k,提示却明确要求旧方图2K,不能认定参数一定会覆盖旧简报。应该先统一真实交付目标,再审核实际文件。官方输入优先级

关键要点

搜索整段简报里的尺寸表达

不要只看表单里最后改过的两个值。检查复制的旧提示、参考图说明、交付备注中是否仍写着“正方形”“1:1”“2K”“按原尺寸”等要求。也要区分“参考图本身是方图”和“输出必须是方图”,两句话承担不同职责。

建议记录三层:当前用途、实际提交参数、实际提示全文。如果团队只展示了设计界面的选择,而不能确认发送给API的内容,就先让负责调用的人取回请求记录,别凭界面记忆判断服务忽略参数。

把参考职责与交付规格写成两句

假设旧图只是用于参考背景颜色,可以写:“第一张用于参考浅灰背景和商品相对位置,不沿用其方形画幅。最终交付为9:16竖版。”再让负责API的人核对同一次请求的 aspect_ratio 与 resolution 是否一致。

这不是额外接口字段,也不是保证系统严格复制参考。它只是减少输入矛盾的写法。Agent 不会追问;有不明确之处会自行判断,因此制作人应先决定需求,不能指望下一轮对话帮你发现所有冲突。

发现的情况 应先处理 避免的错误结论
提示明确写旧方图,参数是竖版 更新提示和参数为同一目标 参数已选,所以提示无关
只有参考图片是方图,提示未要求方图 说明参考用途,再核实际请求 所有方图输入必然输出方图
两处输入一致,返回仍不符 保留请求与文件,调查实际偏差 继续用“默认继承”解释全部情况

旧文的Product to Model省略比例时继承规则适用于另一个端点与条件,不能用来覆盖本篇的明确提示优先级。

分辨率档位也有额外边界

官方将Agent的1k、2k、3k、4k分别描述为约1、4、9、16百万像素,并提醒请求3k或4k时,部分图片会按2k生成和计费。因此,输入没有矛盾,也不能只凭请求4k认定每个返回图都是同一原生档位。

取回真实文件,记录宽高,区分中间图和准备交付的图,再检查标签及边缘。不要把另一个端点的Model Create人脸参考2K上限搬过来解释Agent所有降档现象。每个条件需要自己的文档与运行证据。

假设练习:沿用方形店铺主图简报做竖版广告

假设团队将旧“方形2K主图”提示复制给新的竖版广告请求,只在参数栏改了9:16与4k。第一步应修订交付语句,而不是马上给背景参考裁成竖图。

随后检查竖版构图能否保留商品底部和文案留白。即使最终宽高符合9:16,如果产品被切掉,也仍需修改构图。这与画布、源图和实际导出规格的区分相通,具体工具行为仍以各自文档为准。该练习没有提交API。

最终记录应包含统一后的交付要求、完整请求、实际返回文件及未解决差异。本文依据截至2026年10月31日的 Experimental API 文档,只讨论Agent Images图片端点,未运行或测量任何生成结果。

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