壁纸生成
用固定预设提交单张壁纸任务,服务端排队、限流、可取消,成功后保留 7 天。
输入与参数
presetId— 预设prompt— 画面描述(≤2000 字符)negativePrompt— 排除描述(可选,≤1000 字符)width— 宽度(白名单)height— 高度(白名单)seed— 随机种子(可选整数)
真实示例
presetId=wallpaper, prompt="清晨的山谷,薄雾,柔和侧光", width=1280, height=720, seed=42
→ 202 {jobId,status:"queued",createdAt,deadlineAt,pollAfterMs:2000};轮询到 succeeded 后 POST download 得到 5 分钟短期链接。本轮无 GPU,真实图像未生成。
限制与失败处理
无 GPU/数据库/对象存储配置时接口返回 503;模型 revision 尚未在实机选定,不得宣称 FLUX/SDXL 已跑通;不得上传任意模型或 workflow;结果桶私有,不提供公开图库。
FAQ
能一次生成多张吗?
首发每次任务只生成 1 张;重复提交请使用新的 Idempotency-Key。
可以自定义尺寸吗?
不可以。宽高组合必须来自该预设白名单,服务端会再次校验。