API reference

Creates a 4-second vertical fashion try-on video hook from your image.

Output

mixed

Mode

Async (poll)

Cost / run

up to 78 credits

Authentication

All calls use your account API key as a bearer token. One key works for every app you can run; runs use your credits.

Inputs

Run (REST)

Returns a generation id immediately; the run produces one or more media files. Poll for the result.

curl https://www.mintdreamer.com/api/v1/characters \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://www.mintdreamer.com/api/v1/apps/aecd99e1-3528-42e5-91bd-fb3c6563c5f9/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"inputs":{"image-upload-msp7tnd51":"https://example.com/input.jpg","prompt-msp7tnmn2":"your prompt here","character-msp7wrtae":"CHARACTER_ID_FROM_CHARACTERS_LIST"}}'

curl https://www.mintdreamer.com/api/v1/generations/GENERATION_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Run (MCP)

Paste into Claude, Cursor, or any MCP client. The first URL exposes all your apps as tools (new ones appear automatically); the second pins just this app. Apps with a Character input can use the bundled characters_list tool to find an owned Character ID.

https://www.mintdreamer.com/api/mcp/YOUR_API_KEY

https://www.mintdreamer.com/api/mcp/YOUR_API_KEY?app=aecd99e1-3528-42e5-91bd-fb3c6563c5f9

Output

A run returns outputs: an array of { url, type, width?, height? }. The URLs point to the generated media.

{
  "generation_id": "aecd99e1-3528-42e5-91bd-fb3c6563c5f9",
  "status": "running"
}

{
  "generation_id": "aecd99e1-3528-42e5-91bd-fb3c6563c5f9",
  "status": "done",
  "outputs": [
    {
      "url": "https://files.mintdreamer.com/gen/abc123/0.png",
      "type": "image",
      "width": 1024,
      "height": 1024
    }
  ]
}

The contract is frozen at publish time — editing the source workflow won't change it until you re-publish.