v1

latestOpenAPI 3.1.02026-07-2310742.5 KB

Create MockAnything AI Mockup

Create a new MockAnything AI mockup. Exactly one of prompt, image_url, or image_file is required.

  • prompt: text prompt used to AI-generate an image. Returns a task_id that must be polled via /mock-anything/status/{taskId}.
  • image_url: URL of an existing image to use as the mockup image. Completes synchronously.
  • image_file: uploaded image file (use multipart/form-data). Completes synchronously.
post/mock-anything/create

Headers

Accept'application/json' required

The request must accept JSON responses.

x-api-keystring required

API key required for authentication.

Request body

promptstring

Text prompt used to AI-generate the mockup image. Required unless image_url or image_file is provided.

image_urlstring uri

URL of an existing image to use as the mockup image. Required unless prompt or image_file is provided.

enhance_promptboolean

Whether to run prompt enhancement before generation. Only applies to the prompt flow.

model'nano_banana_2' | 'nano_banana_lite' | 'seedream_4_0' | 'seedream_4_5' | 'gpt_image_2'

AI model used for generation. Only applies to the prompt flow. Required when style is provided. When omitted, product-backed generations default to nano_banana_2 and prompt-only generations without a product default to seedream_4_0. nano_banana_lite and gpt_image_2 apply to product-backed generations (a product.uuid present).

stylestring

Visual style applied to the AI generation (e.g. polaroid-etsy, ugc, fashion). Use GET /mock-anything/styles?model={model} to list the styles available for a given model; not every model supports every style. When style is provided, model is required.

namestring

Optional mockup name shown in the dashboard and returned in the mockup.name field.

catalog_uuidstring uuid

Optional UUID of the catalog the mockup belongs to. Defaults to the workspace's default catalog.

Response

Template creation started.

successboolean
messagestring
All 10 operations