Ref Library

Use your designs as image URLs

Every design you save in IMAGINE has a stable URL that points to its rendered image. Hand that URL to a video-generation AI, a CLI, a Remotion project or an MCP-capable assistant instead of downloading a file and uploading it again.

Quick start

1
Open My Designs
Your saved designs are listed on My Designs. Each card is one design.
2
Copy the reference URL
The link icon on a card copies that design's reference URL. The small chip next to it shows the first 8 characters of the design ID and copies the full ID when you click it.
3
Paste it into your tool
Anywhere an image URL is accepted, paste it as-is. The URL always redirects to the current rendered image, so it keeps working after you save the design again.

My Designs

Connect via MCP

This page is documentation, not the endpoint — register https://whatif-ep.xyz/api/mcp in your client.

Claude Code

claude mcp add --transport http whatif-ref https://whatif-ep.xyz/api/mcp

Other MCP clients

In Claude Desktop, Cursor and other MCP clients, register the same URL as a remote HTTP MCP server:

https://whatif-ep.xyz/api/mcp

The get_design tool

Give it a design ID and it returns that design's image URL along with its name and dimensions. It can also return the thumbnail as an inline image, so the assistant can actually look at the design.

So you can simply say "use design d9b310ff… as the reference image" and the assistant resolves it for you.

URL forms

Three shapes of the same reference URL. Use whichever your tool prefers.

https://whatif-ep.xyz/ref/{design-id}: Redirects to the current full-size rendered image.
https://whatif-ep.xyz/ref/{design-id}.jpg: Behaves identically, for services that require a file extension.
https://whatif-ep.xyz/ref/{design-id}?size=thumb: Returns the small thumbnail instead of the full-size render.

Three kinds of references

The Ref Library covers three different sources. The first two are images with a reference URL; the third is a layered document with no image.

Your designs: What you make in the editor, listed on My Designs. Each one has a full-size image and a thumbnail, so an assistant can look at the thumbnail and use the full-size image as the reference. A design that has never been rendered at full size has no reference URL yet — open it in the editor and save it once to create one.
The official library: The site's curated artwork: character cutouts and general art. Every asset has a full-size image, and its URL is copied from the image picker inside the editor, with the same link button. Its URL form is https://whatif-ep.xyz/ref/asset/{asset-id}.
Design templates: The curated starting points in the template gallery, the ones you open to begin a design of your own. A template has no full-size image and therefore no reference URL — what you can use is its layer structure. See below.

Design templates

Each card in the template gallery has a small id button — the tag icon in the bottom overlay, just right of the open count. Pressing it copies that template's id, the same way the id chip on a design card does.

A template has no full-size image. Only a thumbnail is stored, and the wallpaper download button draws the picture in your browser at the moment you press it instead of fetching a stored file — so there is nothing to hand out as a URL. Template records carry no url field at all, there is no /ref/… image permalink for a template, and thumbnailUrl is a small preview that must never be used as a full-size source.

What a template is good for is its layers. The layer structure is stored data rather than something that gets rendered, so it is available for every template with no rendering step: a background, a character cutout and a caption come back separately, each with its own position and size. That is what a Remotion project or a video pipeline needs in order to animate the parts independently. The response has the same shape as a design's layers.

Every template can be read through these endpoints, premium ones included. That is how it works today, not a promise about the future.

Endpoints

https://whatif-ep.xyz/api/ref/templates: Lists templates, or looks up exact ones with ?id=uuid1,uuid2. Also accepts search, planType (free or premium), minWidth, limit (1–200, default 50), offset and fields.
https://whatif-ep.xyz/api/ref/templates/{template-id}/layers: Returns the layer structure: the elements in draw order, each with its own position and size.

A list record carries id, name, width, height, aspect, planType and thumbnailUrl; fields=all adds isPublic, backgroundColor, layersUrl, openCount, likeCount and updatedAt. width and height are the template's canvas size, not the size of any image.

MCP tools

The MCP server offers the same three steps as tools, with nothing to register again: list_templates browses and searches, get_template returns one record by id (with preview: true it also attaches the thumbnail as an inline image), and get_template_layers returns the layer structure — the only way to actually use a template's artwork.

Who can open your reference URL

The design ID is the key. Anyone holding the URL can view and download that image without logging in, and can pass the URL on to someone else.

That makes it convenient for tools and collaborators, but do not share the URL of a design you want to keep private. There is currently no way to revoke a URL once it has been shared.

Image quality

The reference URL serves a JPEG at the design's own pixel size. The full-size render is produced when you save the design in the editor; if a design has only ever had a list thumbnail, the URL falls back to that smaller image. Re-open the design in the editor and save it once to produce the full-size render.

For developers

There is a plain HTTP form as well, handy in scripts. It returns JSON metadata including the direct image URL:

curl -s "https://whatif-ep.xyz/api/ref/designs?id=<id>"