Wallpaper generation
Submit a single wallpaper job through a fixed preset: server-side queue, bounded retries, cancellation and 7-day retention.
Inputs and parameters
presetId— Presetprompt— Prompt (≤2000 chars)negativePrompt— Negative prompt (optional, ≤1000 chars)width— Width (whitelist)height— Height (whitelist)seed— Seed (optional integer)
Real example
presetId=wallpaper, prompt="quiet valley at dawn, mist, soft side light", width=1280, height=720, seed=42
→ 202 {jobId,status:"queued",createdAt,deadlineAt,pollAfterMs:2000}; after polling to succeeded, POST download returns a 5-minute scoped link. No GPU this round, so no real image was produced.Limits and failure handling
Without GPU/database/object-store configuration the API returns 503; no model revision has been selected on real hardware, so FLUX/SDXL support is not claimed; arbitrary models or workflows cannot be uploaded; the result bucket is private with no public gallery.
FAQ
Can I generate several images at once?
Launch scope is one image per job; use a fresh Idempotency-Key for a new submission.
Can I use a custom size?
No. Width/height pairs must come from this preset whitelist; the server validates them again.