Create mockups
create_mockupsRender one design into one or more device or print mockups from a screenshot URL, image URL, or base64 image, returning CDN-ready mockup outputs.
Instructions
[mockuuups] Put one design into one or more mockups and render them.
Give exactly one source:
screenshot_url— Mockuuups screenshots the live page itself. Best for websites; costs one extra credit per render.image_url— any publicly reachable image.image_base64— raw image bytes for a design that only exists locally. Mockuuups can only render from a URL, so the image is staged on this server under a short-lived unguessable link for the render to fetch.
Pass several mockup_ids to render the same design across devices in one
call; they run concurrently. Renders that outrun the wait budget come back
as pending with a render_id for get_renders — the CDN links are already
valid and will fill in once the render lands.
Each render costs a credit, +1 for a screenshot, so check account_status before a large batch.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | ||
| image_url | No | ||
| mockup_ids | Yes | ||
| image_base64 | No | ||
| wait_seconds | No | ||
| screenshot_url | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| failed | Yes | ||
| pending | Yes | ||
| renders | Yes | ||
| summary | Yes | ||
| requested | Yes | ||
| succeeded | Yes | ||
| credits_spent | Yes |