MockAnything AI API
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 atask_idthat 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 (usemultipart/form-data). Completes synchronously.
API key required for authentication.
The request must accept JSON responses.
API key required for authentication.
YOUR_API_KEY_HEREText prompt used to AI-generate the mockup image. Required unless image_url or image_file is provided.
URL of an existing image to use as the mockup image. Required unless prompt or image_file is provided.
Whether to run prompt enhancement before generation. Only applies to the prompt flow.
AI model used for generation. Only applies to the prompt flow. Required when style is provided. When omitted, generations default to nano_banana_2, which runs on Nano Banana 2.1 (Google's gemini-nano-banana-2.1) since October 2026. nano_banana_lite and gpt_image_2 apply to product-backed generations (a product.uuid present).
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.
polaroid-etsyOptional mockup name shown in the dashboard and returned in the mockup.name field.
Optional UUID of the catalog the mockup belongs to. Defaults to the workspace's default catalog.
Template creation started.
trueTemplate creation startedBad request due to invalid input parameters (e.g. missing prompt/image_url/image_file, invalid model, unsupported image type).
Unauthorized request, invalid or missing API key.
No credits available, or the authenticated user does not have access to the provided catalog or collection.
The provided catalog_uuid or a collections[].uuid could not be found.
An exact product color, decoration position, or decoration source does not exist on the selected product.
Failed to start AI generation or upload the provided image.
Product detail is temporarily unavailable, so an explicit color_name, position_id, or source selector cannot be validated safely.
POST /api/v1/mock-anything/create HTTP/1.1
Host: app.dynamicmockups.com
x-api-key: text
Accept: application/json
Content-Type: application/json
Content-Length: 72
{
"prompt": "A man jogging through a sunny park in a plain white t-shirt"
}{
"data": {
"task_id": "f6d7fb41-d32c-4fc3-8db9-37843d3476cf",
"status": "submitted",
"selected_size": "A3",
"aspect_ratio": "1:1",
"warnings": [
{
"location": "back_full",
"code": "no_placed_print_area_for_location",
"message": "This product has no placed print-area geometry for 'back_full'; artwork placed there will not render."
}
]
},
"success": true,
"message": "Template creation started"
}Poll the status of a MockAnything AI mockup creation task. The response contains a state field:
PROGRESS: the task is still running.image_urlandmockuparenull.SUCCESS: the task finished and the mockup has been created.image_urlis populated andmockupcontains a payload that can be used immediately asmockup_uuidin the Render API.
Other states (e.g. FAILURE) indicate the task terminated without producing a mockup.
API key required for authentication.
The task_id returned from POST /mock-anything/create.
f6d7fb41-d32c-4fc3-8db9-37843d3476cfThe request must accept JSON responses.
API key required for authentication.
YOUR_API_KEY_HERETask status retrieved successfully. Response shape depends on task state.
Unauthorized request, invalid or missing API key.
Failed to retrieve task status from the rendering service.
GET /api/v1/mock-anything/status/{taskId} HTTP/1.1
Host: app.dynamicmockups.com
x-api-key: text
Accept: application/json
{
"data": {
"task_id": "f6d7fb41-d32c-4fc3-8db9-37843d3476cf",
"state": "PROGRESS",
"image_url": null,
"status": "processing",
"mockup": null
},
"success": true,
"message": "Task is being processed"
}Search the Print-on-Demand (POD) product catalog used to ground AI generations. The returned uuid can be passed as product.uuid when creating a mockup so the generated image is anchored to that specific product (e.g. a Gildan 5000 t-shirt).
API key required for authentication.
Search term matched against POD product names.
gildanJSON is recommended; errors return JSON regardless of this header.
API key required for authentication.
YOUR_API_KEY_HEREPOD products matching the query.
trueUnauthorized request, invalid or missing API key.
Validation error. query is missing or empty.
Failed to fetch POD products.
GET /api/v1/mock-anything/products?query=text HTTP/1.1
Host: app.dynamicmockups.com
x-api-key: text
Accept: */*
{
"data": [
{
"name": "Gildan Heavy Cotton™ T-Shirt - 5000",
"uuid": "b93d68ae-928d-4e3a-a183-a2940a1a81c2"
},
{
"name": "Gildan Heavy Cotton™ Youth T-Shirt - 5000B",
"uuid": "b0e134d4-bf89-4a63-b6f1-66ba56f3acad"
},
{
"name": "Gildan Heavy Cotton™ Women's T-Shirt - 5000L",
"uuid": "b483c1c6-89e4-4e65-8067-8f227d03c80c"
}
],
"success": true,
"message": ""
}Get the full detail of a single POD product: its identity, available decoration areas (decorations), colors, and supported sizes. Use a decoration's position_id and one of its sources for exact selection when creating a mockup. location remains available for canonical area selection. Each decoration also lists the decoration_methods its enabled stored sources claim and a default_decoration_method (null when the data carries none); candidate_decoration_methods are category-level class-profile guesses and do not count as support. A decoration with enabled: false reports no methods and no default.
API key required for authentication.
UUID of the POD product (from GET /mock-anything/products).
8429f141-5289-4d3b-9a83-7417130adc3aThe request must accept JSON responses.
API key required for authentication.
YOUR_API_KEY_HEREProduct detail retrieved successfully.
trueUnauthorized request, invalid or missing API key.
Product not found.
Failed to fetch the product detail.
GET /api/v1/mock-anything/products/{uuid} HTTP/1.1
Host: app.dynamicmockups.com
x-api-key: text
Accept: application/json
{
"data": {
"uuid": "8429f141-5289-4d3b-9a83-7417130adc3a",
"name": "Heavy Cotton T-Shirt",
"brand": "Gildan",
"style_code": "5000",
"category": "t_shirt",
"subcategory": "short_sleeve",
"decorations": [
{
"position_id": "gearlaunch_front",
"location": "front",
"name": "Full Chest",
"surface": "front",
"sources": [
"gearlaunch"
],
"enabled": true,
"decoration_methods": [
"dtg",
"screen_print"
],
"default_decoration_method": "dtg",
"candidate_decoration_methods": []
},
{
"location": "left_chest",
"position_id": "left_chest",
"name": "Left Chest",
"surface": "front",
"sources": [
"supplier-decoration-spec-via-asi"
]
},
{
"location": "back_full",
"position_id": "back_full",
"name": "Full Back",
"surface": "back",
"sources": [
"supplier-decoration-spec-via-asi"
]
}
],
"colors": [
{
"name": "White",
"hex": "#FFFFFF"
},
{
"name": "Black",
"hex": "#25282A"
}
],
"supported_sizes": [
"S",
"M",
"L",
"XL",
"2XL"
]
},
"success": true,
"message": ""
}List the visual styles that can be applied to an AI-generated mockup. The returned id can be passed as style when creating a mockup to apply that aesthetic to the generation. Pass a model query parameter to scope the result to styles supported by that model; not every model supports every style. When model is omitted the response includes every known style across all models.
API key required for authentication.
Optional model filter. When provided, only styles available for that model are returned.
nano_banana_2Possible values: The request must accept JSON responses.
API key required for authentication.
YOUR_API_KEY_HEREAvailable styles.
trueBad request. Invalid model value.
Unauthorized request, invalid or missing API key.
Failed to fetch styles.
GET /api/v1/mock-anything/styles HTTP/1.1
Host: app.dynamicmockups.com
x-api-key: text
Accept: application/json
{
"data": [
{
"id": "baseline",
"description": "Default, with no stylistic modification. Matches the standard pipeline behavior. Safe to use with every model.",
"available_with": [
"seedream_4_0",
"seedream_4_5",
"nano_banana_2"
]
},
{
"id": "polaroid-etsy",
"description": "SX-70 instant film: warm whites, soft light leaks, quiet morning intimacy. Etsy lifestyle product photography.",
"available_with": [
"nano_banana_2"
]
}
],
"success": true,
"message": ""
}Overview
MockAnything AI lets you create a new mockup on the fly, either by generating an image from a text prompt or by bringing an image you already have. Once created, each mockup behaves exactly like one from the Get Mockups API - you pass its uuid to the Render Mockup API to print artwork on it.
Creation is asynchronous: you submit a task, then poll until the mockup is ready.
Workflow
(Optional) Search POD products to find a
product.uuidfor grounding the generation around a specific product.(Optional) Get a product's decoration areas via
Get POD Product Detailsaction, then target one or more withproduct.decorationson the mockup creation.(Optional) List available styles to set the visual direction of a mockup using a
styleparameter.Call Create MockAnything AI Mockup. You get back a
task_id.Poll Get MockAnything AI Mockup Status until
stateisSUCCESS. The response includes amockupobject. Usemockup.uuidas themockup_uuidin the Render Mockup API.
Three ways to create a mockup
prompt - Generate a brand-new image with AI. Best when you don't already have reference imagery, or when you want to quickly produce variations of a scene. Runs
asynchronously.
image_url - Turn a publicly-accessible image into a MockAnything mockup. Use this when you already host product photos somewhere. Completes on the first status call.
image_file - Upload an image file directly (multipart/form-data). Best for private images you don't want to host publicly. Completes on the first status call.
Exactly one of these three must be provided per request. The remaining fields (name, collections, catalog_uuid) work the same for all three modes.
Polling for completion
After POST /mock-anything/create, poll GET /mock-anything/status/{taskId} with the returned task_id. The response contains a state field:
PROGRESS- still running.image_urlandmockuparenull. Poll again in a moment.SUCCESS- ready.image_urlis populated andmockupcontains everything you need for the Render Mockup API.FAILURE- the task terminated without producing a mockup.
Using your new mockup
Once state is SUCCESS, the mockup field looks identical to an entry from the Get Mockups API, with type: "mockanything". Three fields matter for rendering:
mockup.uuid- pass asmockup_uuidin the Render Mockup API.mockup.smart_objects[].uuid- each print area detected on the image. Reference these assmart_objects[].uuidin the Render Mockup API payload to place your artwork on each area.mockup.smart_objects[].decoration- optional decoration area for this product, when the mockup was grounded with aproduct.uuidon mockup creation. Use it to pick the right smart object for a specific spot.
From here everything works exactly like rendering a classic mockup. The Render Mockup API handles both types through the same endpoint, so you don't need a separate integration.
Grounding the AI with a product
If you want the AI to anchor the generated image around a specific product (say a Gildan 5000 t-shirt rather than a generic tee), first look up a product with Search POD Products, then pass the returned uuid as product.uuid on the create request.
GET /mock-anything/products?query=gildan
The response is a simple list of { name, uuid } entries. Pick the one that matches the product you're mocking up.
Targeting decoration areas
When you ground a generation with a product, you can also tell the AI where on that product the artwork should sit - the full chest, left chest, a sleeve, the back, and so on. These spots are called decorations.
First, look up the decorations a product offers with Get POD Product Details:
GET /mock-anything/products/{uuid}
The response includes a decorations array. Each entry has a location (the ID you pass back on create), a human-readable name, and the surface it sits on:
Then pass the location(s) you want as product.decorations on the mockup creation request:
Set visual direction with a style
If you want the AI mockup to land in a specific look (warm Polaroid, editorial flash, casual UGC, etc.) instead of the default photographic style, list the styles available for your chosen model with List Available Styles, then pass the returned id as style on the create request.
GET /mock-anything/styles?model=nano_banana_2
The response is a list of { id, description, available_with } entries. Read the description to pick the look you want, then send its id as style.
Catalogs and collections
MockAnything mockups live inside your catalogs and collections, the same as any other mockup:
catalog_uuid- places the mockup in a specific catalog. Defaults to your workspace's default catalog. See the Catalogs API to list available catalogs.collections- attaches the mockup to one or more collections. Each entry is either an existing collection referenced byuuid, or a new one referenced byname(which will find-or-create for you). See the Collections API to manage collections.
Choosing a model
The model parameter controls which AI model generates your image. Different models trade off speed, quality, and credit cost. If you don't set model, generation will use seedream_4_0 as default.
seedream_4_0
~20s
Medium
Quick iterations and early exploration
seedream_4_5
~40s
Good
Higher fidelity without the pro price
nano_banana_2
~30s
High
Production-quality, final mockups
Rate Limit
Create MockAnything AI Mockup endpoint is limited to 50 requests per minute.
Requests exceeding this limit will receive a 429 Too Many Requests response. If you expect
higher throughput, contact support to discuss your use case.
Last updated