API reference

将中国诗词生成视频

Output

mixed

Mode

Async (poll)

Cost / run

up to 221 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 -X POST https://www.mintdreamer.com/api/v1/apps/fbab61af-6399-4704-9efd-7f284fe0a013/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"inputs":{"poem":"your prompt here"}}'

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=fbab61af-6399-4704-9efd-7f284fe0a013

Output

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

{
  "generation_id": "fbab61af-6399-4704-9efd-7f284fe0a013",
  "status": "running"
}

{
  "generation_id": "fbab61af-6399-4704-9efd-7f284fe0a013",
  "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.