Article
Photoroom API 只写海边却多了日落道具，怎样核自动扩写？
Photoroom AI Backgrounds默认扩写文字提示。了解background.expandPrompt.mode=ai.never的表单写法、ai.auto对照与只作用background.prompt的边界，避免将禁用扩写误当商品保真保证。
先检查实际请求中的扩写设置。Photoroom AI Backgrounds官方文档说明，默认会扩写背景文字提示并整合主体描述；显式设置 background.expandPrompt.mode=ai.never 可禁用这一步。这不等于禁止日落、固定场景或保证商品保真，画面差异仍需按任务审核。
关键要点
- 核实际提交的
background.prompt与background.expandPrompt.mode，不只看文案表。- 当前禁用值为
ai.never；ai.auto表示自动扩写。- 该设置只作用文字提示，不是参考图、商品保真或负面提示总开关。
把简短主题变成可判断的制作任务
写清“海边”这次承担什么职责：是仅需要明亮的海岸氛围，还是必须与某张批准背景的时间、颜色和空间关系一致。若没有规定日落或日间，生成一张日落并不自动证明系统违背了已提交条件。
将商品事实与场景偏好分开。水壶的颜色、部件和数量来自真实商品；夕阳、贝壳或杯子是场景元素。额外道具若会被误认为随商品附送，应当先隔离该候选，不能等参数排查完成才处理宣传含义。
按官方表单示例显式关闭扩写
下列请求骨架沿用官方功能文档的 POST 表单写法，凭据和文件路径均为占位符，本文未执行请求、未消费额度。运行前须使用自己的有效账号和有权使用的原片；这段示例不代表本站已集成该接口。
curl --request POST 'https://image-api.photoroom.com/v2/edit' \
--header 'x-api-key: YOUR_API_KEY' \
--form 'imageFile=@/path/to/image.jpeg' \
--form 'referenceBox=originalImage' \
--form 'background.prompt=on a beach' \
--form 'background.expandPrompt.mode=ai.never'
这是 multipart/form-data 表单示例，不要把 POST 的文件上传改成随意拼接的查询字符串。referenceBox=originalImage 保留自官方示例，并不表示本文已证明它在所有请求中都是最少必填字段。示例英文提示用于说明结构，实际文字应写清已批准的场景。
若接入工具把字段藏在表单映射里，检查发送前实际负载是否含完整点号字段和 ai.never，并确认没有被上游覆盖。只在文案表加一列、改 Studio 助手或改一个没有发送的草稿，都不能证明此次请求关闭了扩写；没有负载记录时先补记录。
分清当前值、旧写法与控制范围
官方API参考列出当前模式 ai.auto、ai.never，并说明不带 ai. 的 auto、never 属旧值。不要将历史代码中的旧值当作新接入推荐；迁移时核当前客户端真正序列化出的请求。默认扩写来自功能文档说明，不是本文发现 OpenAPI 存在某个 default 键。
该模式只影响 background.prompt，不能当作 background.guidance 参考图的总开关，也不等于 background.negativePrompt。本题不需要把其他字段的模型限制移植到扩写设置。若同时提交静态背景图与生成背景提示，应先按接口的字段兼容规则分开路线，不能靠 ai.never 消除冲突。
| 当前证据 | 可以决定什么 | 还不能决定什么 |
|---|---|---|
实际发送 ai.never |
本次显式禁用文字扩写 | 不会出现任何道具或商品变化 |
实际发送 ai.auto |
本次允许自动扩写 | 输出必然符合短提示全部隐含要求 |
| 未发送或记录不明 | 查接入层是否注入模式 | 单靠界面文案确认实际模式 |
| 只看见多余日落或道具 | 按制作任务决定候选是否可用 | 仅凭画面证明扩写是唯一原因 |
虚构练习：白色保温瓶的海岸图
以下为虚构练习，未调用 Photoroom API。团队写了“海边”，但实际需要的是日间、干净台面与明确商品主体。候选出现夕阳、贝壳和另一只杯子。
团队先写清日间海岸、商品单独呈现等制作条件，再由接口负责人保留同一原片、同一提示与其他输入，分别显式记录 ai.auto、ai.never。这是一项待执行的比较安排，不是已经观察到关闭后道具消失。若当前模式或模型版本不明，先补记录，不把比较预填为成功；也不要求填写一个未经文档确认会返回的“最终扩写文本”响应字段。
候选即使没有贝壳，只要瓶盖变成另一种结构，也不能通过；如果道具存在但符合已批准的布景目的，则应按任务判断，而不是一概把“增加内容”当错误。练习没有验证任何控制效果或确定性复现。
关闭扩写后，验收仍看实际成图
最终记录保留原片身份、实际提示、模式、模型版本及输出文件身份，不保存密钥。用已批准商品信息检查颜色、部件、数量，再核场景是否误导随附物和使用条件。禁用文字改写只处理一个输入步骤；需要跨图固定背景时，可另读已发布的静态背景分流，不在这里重复展开。
跨入口的提示来源可读Studio助手与API请求的区别（英文），其规则不能直接套本接口。稳定性判断参考提示复用与静态背景分流；场景审核继续用让背景解释商品（英文）。
本文由 Itemlume 编辑团队依据截至2026年10月29日核对的官方资料整理，采用 AI 辅助编辑。案例为虚构练习，未运行扩写或对照生成；第三方接口不代表本站集成。了解编辑主体或联系勘误。