For an image the user does not have. An image they supplied — an attachment or a public URL — is uploaded instead: Upload Media to Wix.
API reference: About the Wix AI APIs, Generating images — endpoint, auth, and the full model table. Developer Preview, so confirm the contract there.
Each call spends roughly one AI credit, billed to the site owner, or to the Wix user who installed the calling app. numberResults: n spends n. Importing is free.
Generate one image per entity that needs one, and say how many a run will generate before starting it. Regenerate only when the user asks.
| Parameter | Value |
|---|---|
taskUUID | A real UUIDv4. Anything else returns 400 invalidTaskUUID |
width / height | 1024×1024 (square — products, services, menu items), 1376×768 (16 hero), 1200×896 (4 editorial). Free-form sizes return 400 |
model | See below |
numberResults | 1 |
Omit steps and CFGScale: Runware accepts them, other models return 400 unsupportedParameter.
model | Latency | Content filter |
|---|---|---|
runware:400@1 | ~5s | Loosest — the default |
google:4@2 | ~25s | Medium, best fidelity |
bfl:5@1 | — | Strictest; refuses trademark-ish prompts |
Any Runware-supported model works — the reference's Suggested models table has the current AIR IDs.
A refusal is a success response with no imageURL — test for the field, not the status. On a refusal, reword the prompt or switch model, and report the image as not created.
imageURL expires, so import it as it lands. Upload Media to Wix owns that endpoint and its PENDING / READY rules; pass the imageURL as url and image/png as mimeType.
The result is the returned file.id / file.url — permanent, and what an entity field takes.
runware:400@1 and bfl:5@1 take several tasks in one body. google:4@2 returns 504 at three or more, so fire parallel single-task requests for it.
Failure is per image: attach the ones that succeeded, create the rest of the entities text-only, and name which entities have no image and why. A failed image stays missing rather than being swapped for another.
For JavaScript callers there is an SDK path — generateImage() from the Vercel AI SDK with runware.image(...) from @wix/ai: Set up the Wix AI SDK.
Last updated: 3 September 2026