{ "info": { "name": "Magnific — mcp.ai", "description": "REST API for the Magnific MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.mcp.ai/api/magnific", "type": "string" }, { "key": "apiKey", "value": "sk_live_...", "type": "string" } ], "item": [ { "name": "magnific_account_balance", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/account/balance", "host": [ "{{baseUrl}}" ], "path": [ "account", "balance" ] }, "description": "User plan + credits. Check before paid generations. Returns plan.{tier,productName,isUnlimitedMode}, credits.{available,totalPlan,spent,hasExtraCredits}. No history.", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_audio_music_generate", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/audio/music/generate", "host": [ "{{baseUrl}}" ], "path": [ "audio", "music", "generate" ] }, "description": "AI music generation. Google Lyria or ElevenLabs. Pass `prompt`, optional `model`/`durationSeconds`/`instrumental`. Lyria/Lyria-3 produce fixed 30s; Lyria-3-Pro accepts 30–180s; ElevenLabs accepts 10–3", "body": { "mode": "raw", "raw": "{\n \"prompt\": \"\",\n \"model\": \"\",\n \"durationSeconds\": 0,\n \"instrumental\": false,\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_audio_tts", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/audio/tts", "host": [ "{{baseUrl}}" ], "path": [ "audio", "tts" ] }, "description": "TTS voiceover. Single (voiceId) or 2-speaker (speakers). ElevenLabs/Google. No voiceId? Call `audio_voices_show` first (or `audio_voices_list` for agent-only lookup).", "body": { "mode": "raw", "raw": "{\n \"text\": \"\",\n \"voiceId\": 0,\n \"speakers\": \"\",\n \"model\": \"\",\n \"stability\": 0,\n \"similarityBoost\": 0,\n \"speed\": 0,\n \"useSpeakerBoost\": false,\n \"temperature\": 0,\n \"systemInstruction\": \"\",\n \"visible\": false,\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_audio_voices_list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/audio/voices/list", "host": [ "{{baseUrl}}" ], "path": [ "audio", "voices", "list" ] }, "description": "TTS voice catalog as raw TOON text, no UI. Lean entries without preview URLs. Optional `search` filters by name, description, gender, or language.", "body": { "mode": "raw", "raw": "{\n \"search\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_comment", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/comment", "host": [ "{{baseUrl}}" ], "path": [ "creations", "comment" ] }, "description": "Add a comment (or reply) to a user-owned creation.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"folderReference\": \"\",\n \"text\": \"\",\n \"replyToCommentId\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_finalize_upload", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/finalize/upload", "host": [ "{{baseUrl}}" ], "path": [ "creations", "finalize", "upload" ] }, "description": "Step 2 after PUT from `creations_request_upload`: convert temp path(s) to creations. Images <=25MB, videos <=200MB.", "body": { "mode": "raw", "raw": "{\n \"path\": \"\",\n \"uploads\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_get", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/get", "host": [ "{{baseUrl}}" ], "path": [ "creations", "get" ] }, "description": "Single creation complete data — metadata + URLs (`url` full-res, `previewUrl` ~1024px, `thumbnailUrl` ~400px).", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_like", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/like", "host": [ "{{baseUrl}}" ], "path": [ "creations", "like" ] }, "description": "Toggle heart/favorite reaction on a user-owned creation.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"folderReference\": \"\",\n \"unlike\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/list", "host": [ "{{baseUrl}}" ], "path": [ "creations", "list" ] }, "description": "Filterable gallery widget (image/video/audio). Use instead of `creations_search` when user wants to browse their library.", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"reference\": \"\",\n \"query\": \"\",\n \"fileType\": \"\",\n \"toolNames\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_move", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/move", "host": [ "{{baseUrl}}" ], "path": [ "creations", "move" ] }, "description": "Move creations into `targetFolderReference`. Identifiers from `images_generate`/`creations_search`. Foreign identifier → abort. Target folder must belong to user.", "body": { "mode": "raw", "raw": "{\n \"targetFolderReference\": \"\",\n \"creationIdentifiers\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_request_upload", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/request/upload", "host": [ "{{baseUrl}}" ], "path": [ "creations", "request", "upload" ] }, "description": "Step 1 for local/user files: get presigned PUT URL(s). Upload bytes outside MCP, then call `creations_finalize_upload`.", "body": { "mode": "raw", "raw": "{\n \"mimeType\": \"\",\n \"count\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_search", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/search", "host": [ "{{baseUrl}}" ], "path": [ "creations", "search" ] }, "description": "Search user creations as raw TOON text. Use `creations_get` for one id. `reference` required with from=folder/project-root. Defaults: history, page 1.", "body": { "mode": "raw", "raw": "{\n \"from\": \"\",\n \"reference\": \"\",\n \"query\": \"\",\n \"page\": 0,\n \"folderReference\": \"\",\n \"fileType\": \"\",\n \"toolNames\": \"\",\n \"excludeToolNames\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_upload_file", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/upload/file", "host": [ "{{baseUrl}}" ], "path": [ "creations", "upload", "file" ] }, "description": "Import a file the user attached in the host (e.g. a ChatGPT upload) as a creation, then use the returned identifier in image tools. Use this instead of asking for a URL when the user already uploaded ", "body": { "mode": "raw", "raw": "{\n \"file\": {}\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_upload_image", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/upload/image", "host": [ "{{baseUrl}}" ], "path": [ "creations", "upload", "image" ] }, "description": "Upload public image URL in one step. For local/user files use `creations_request_upload` then `creations_finalize_upload`.", "body": { "mode": "raw", "raw": "{\n \"url\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_creations_wait", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/creations/wait", "host": [ "{{baseUrl}}" ], "path": [ "creations", "wait" ] }, "description": "Long-poll 1..8 creations until terminal or `timeoutSeconds` (default 25, max 25). In-progress entries get `poll_after_seconds` for the next call.", "body": { "mode": "raw", "raw": "{\n \"identifiers\": \"\",\n \"timeoutSeconds\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_design_auto_layers", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/design/auto/layers", "host": [ "{{baseUrl}}" ], "path": [ "design", "auto", "layers" ] }, "description": "Extract editable layers from a flat image into a Pikaso design.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"name\": \"\",\n \"numLayers\": 0,\n \"vectorize\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_design_auto_resize", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/design/auto/resize", "host": [ "{{baseUrl}}" ], "path": [ "design", "auto", "resize" ] }, "description": "Create resized design pages from an image. Use directly when ratios/social formats are known; otherwise show `design_auto_resize_show`.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"aspectRatios\": \"\",\n \"name\": \"\",\n \"textLayers\": false,\n \"imageLayers\": false,\n \"numLayers\": 0,\n \"multipage\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_flows_get", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/flows/get", "host": [ "{{baseUrl}}" ], "path": [ "flows", "get" ] }, "description": "Flow input/output spec as raw TOON text. Each input includes a normalized `kind`, `howToProvide`, and resolved `options`/`presetOptions` where applicable. Call before `flows_run`.", "body": { "mode": "raw", "raw": "{\n \"identifier\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_flows_list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/flows/list", "host": [ "{{baseUrl}}" ], "path": [ "flows", "list" ] }, "description": "Flows catalog as raw TOON text, no UI. Lean entries without preview URLs. For an inline picker use flows_show; for a single flow input/output spec use flows_get.", "body": { "mode": "raw", "raw": "{\n \"query\": \"\",\n \"ownership\": \"\",\n \"page\": 0,\n \"perPage\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_flows_run", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/flows/run", "host": [ "{{baseUrl}}" ], "path": [ "flows", "run" ] }, "description": "Run flow. `flows_get` first for input specs. `inputs` is `{inputId: value}` (creation inputs from `creations_list`, voices from `audio_voices_show`). Returns `workflowRunIdentifier` → `flows_wait` → `", "body": { "mode": "raw", "raw": "{\n \"identifier\": \"\",\n \"inputs\": {}\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_flows_wait", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/flows/wait", "host": [ "{{baseUrl}}" ], "path": [ "flows", "wait" ] }, "description": "Long-poll a `flows_run`. Terminal: one entry per output creation with real `identifier` for `creations_show`. In-progress: `poll_after_seconds`.", "body": { "mode": "raw", "raw": "{\n \"workflowRunIdentifier\": \"\",\n \"timeoutSeconds\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_folders_create", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/folders/create", "host": [ "{{baseUrl}}" ], "path": [ "folders", "create" ] }, "description": "Create folder/project. No `parentReference`: workspace root. `type` defaults: project at root, folder when nested.", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"parentReference\": \"\",\n \"type\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_folders_delete", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/folders/delete", "host": [ "{{baseUrl}}" ], "path": [ "folders", "delete" ] }, "description": "Move a folder and its files to trash.", "body": { "mode": "raw", "raw": "{\n \"reference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_folders_get", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/folders/get", "host": [ "{{baseUrl}}" ], "path": [ "folders", "get" ] }, "description": "Fetch folder metadata by `reference`. Use before `creations_search` (`from=folder`). Foreign refs error.", "body": { "mode": "raw", "raw": "{\n \"reference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_folders_list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/folders/list", "host": [ "{{baseUrl}}" ], "path": [ "folders", "list" ] }, "description": "List folders/projects as raw TOON text. No params=top level; `onlyProjects`=projects; `parentReference`=children. Refs work with creations/folder tools.", "body": { "mode": "raw", "raw": "{\n \"parentReference\": \"\",\n \"onlyProjects\": false,\n \"page\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_folders_rename", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/folders/rename", "host": [ "{{baseUrl}}" ], "path": [ "folders", "rename" ] }, "description": "Rename a folder by `reference`.", "body": { "mode": "raw", "raw": "{\n \"reference\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_change_camera", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/change/camera", "host": [ "{{baseUrl}}" ], "path": [ "images", "change", "camera" ] }, "description": "Reframe camera around subject. Defaults: rotate=45, vertical=0, closeup=5.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"rotate\": 0,\n \"vertical\": 0,\n \"closeup\": 0,\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_crop", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/crop", "host": [ "{{baseUrl}}" ], "path": [ "images", "crop" ] }, "description": "Center-crop to `aspectRatio`. Pixels: `images_resize`. AI upscale: `images_upscale`. Ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"aspectRatio\": \"\",\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_generate", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/generate", "host": [ "{{baseUrl}}" ], "path": [ "images", "generate" ] }, "description": "Generate/edit images. No refs=TTI. references[] (max 12; see field docs). Defaults: mode=auto, ratio=1:1, count<=8. resolution/quality per images_models_list. UI clients: after generating, MUST call `", "body": { "mode": "raw", "raw": "{\n \"prompt\": \"\",\n \"mode\": \"\",\n \"aspectRatio\": \"\",\n \"references\": \"\",\n \"count\": 0,\n \"resolution\": \"\",\n \"quality\": \"\",\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_generate_svg", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/generate/svg", "host": [ "{{baseUrl}}" ], "path": [ "images", "generate", "svg" ] }, "description": "Text-to-SVG (Recraft v4 Pro Vector). Raster: `images_generate`. Trace existing raster: `images_to_svg`. Default aspectRatio=1:1.", "body": { "mode": "raw", "raw": "{\n \"prompt\": \"\",\n \"aspectRatio\": \"\",\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_models_list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/models/list", "host": [ "{{baseUrl}}" ], "path": [ "images", "models", "list" ] }, "description": "TTI model catalog as lean TOON text. `search` filters by name, slug, description, or tags.", "body": { "mode": "raw", "raw": "{\n \"search\": \"\",\n \"onlyRecommended\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_relight", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/relight", "host": [ "{{baseUrl}}" ], "path": [ "images", "relight" ] }, "description": "AI relight. 1-4 lights with azimuth/elevation enums, type neutral|gel, intensity 1-10. Gel uses hex `color`.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"lights\": \"\",\n \"resolution\": \"\",\n \"numImages\": 0,\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_remove_background", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/remove/background", "host": [ "{{baseUrl}}" ], "path": [ "images", "remove", "background" ] }, "description": "Cut-out subject on transparent PNG. Color BG: `images_color_background`. AI scene: `images_generate` with reference + prompt \"replace the background with X\".", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_resize", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/resize", "host": [ "{{baseUrl}}" ], "path": [ "images", "resize" ] }, "description": "Resize to exact pixels (no AI). For real detail upscaling: `images_upscale` first. Aspect: `images_crop`. Dimensions snap to multiples of 8; center-crop on aspect mismatch.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"width\": 0,\n \"height\": 0,\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_skin_enhancer", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/skin/enhancer", "host": [ "{{baseUrl}}" ], "path": [ "images", "skin", "enhancer" ] }, "description": "AI skin enhancer. faithful preserves identity; creative reinterprets; flexible uses presets. Defaults: faithful, sharpen=0, smartGrain=0.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"version\": \"\",\n \"sharpen\": 0,\n \"smartGrain\": 0,\n \"skinDetail\": 0,\n \"optimizedFor\": \"\",\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_to_svg", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/to/svg", "host": [ "{{baseUrl}}" ], "path": [ "images", "to", "svg" ] }, "description": "Trace raster creation into SVG. New vector from prompt: `images_generate_svg`.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_upscale", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/upscale", "host": [ "{{baseUrl}}" ], "path": [ "images", "upscale" ] }, "description": "AI upscale 2x/4x (Magnific, premium). Exact pixels: `images_resize`. Aspect: `images_crop`. Default scale=2.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"scale\": \"\",\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_images_variations", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/images/variations", "host": [ "{{baseUrl}}" ], "path": [ "images", "variations" ] }, "description": "Generate image-variation grid. Modes: angles|demographics|expressions|age|storyboard|custom. Defaults: angles, 3x3, 1:1, 4k.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"variationMode\": \"\",\n \"prompt\": \"\",\n \"gridRows\": 0,\n \"gridCols\": 0,\n \"aspectRatio\": \"\",\n \"resolution\": \"\",\n \"selectedAngles\": \"\",\n \"selectedEthnicities\": \"\",\n \"selectedGenders\": \"\",\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_library_create", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/library/create", "host": [ "{{baseUrl}}" ], "path": [ "library", "create" ] }, "description": "Create a reusable library asset (character/product/location) from 1-6 images. Use the returned numeric `id` in generation refs (same id Spaces uses). No LoRA training.", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"type\": \"\",\n \"description\": \"\",\n \"gender\": \"\",\n \"productType\": \"\",\n \"images\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_library_list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/library/list", "host": [ "{{baseUrl}}" ], "path": [ "library", "list" ] }, "description": "Lean library catalog (characters, styles, elements, locations) for agent reasoning. Picker assets use library://.", "body": { "mode": "raw", "raw": "{\n \"scope\": \"\",\n \"type\": \"\",\n \"page\": 0,\n \"perPage\": 0,\n \"search\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_models3d_generate", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/models3d/generate", "host": [ "{{baseUrl}}" ], "path": [ "models3d", "generate" ] }, "description": "Image-to-3D GLB. Upload external images first. Animate with `models3d_rig`. Models: tripo-p1 default, tripo-v31, trellis-2.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"model\": \"\",\n \"resolution\": 0,\n \"textureQuality\": \"\",\n \"faceLimit\": 0,\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_project_report", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/project/report", "host": [ "{{baseUrl}}" ], "path": [ "project", "report" ] }, "description": "English markdown status report for a project/folder. Last 7 days default, max 30.", "body": { "mode": "raw", "raw": "{\n \"reference\": \"\",\n \"days\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_spaces_create", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spaces/create", "host": [ "{{baseUrl}}" ], "path": [ "spaces", "create" ] }, "description": "Create empty Space. Share `space.webUrl`; only call `spaces_show` when inline preview is requested.", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_spaces_edit", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spaces/edit", "host": [ "{{baseUrl}}" ], "path": [ "spaces", "edit" ] }, "description": "External MCP only. Start headless Space edit. Poll `spaces_edit_status` until allTerminal, then verify with `spaces_state`.", "body": { "mode": "raw", "raw": "{\n \"query\": \"\",\n \"spaceId\": \"\",\n \"threadId\": \"\",\n \"selectedElementIds\": \"\",\n \"selectedConnectionIds\": \"\",\n \"anchorElementId\": \"\",\n \"anchorDirection\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_spaces_edit_status", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spaces/edit/status", "host": [ "{{baseUrl}}" ], "path": [ "spaces", "edit", "status" ] }, "description": "Wait for `spaces_edit` like `creations_wait`: long-polls up to `timeoutSeconds` (default 25, max 25). Snapshot-only when 0. Terminal → `spaces_state`.", "body": { "mode": "raw", "raw": "{\n \"operationId\": \"\",\n \"threadId\": \"\",\n \"runId\": \"\",\n \"timeoutSeconds\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_spaces_get_nodes", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spaces/get/nodes", "host": [ "{{baseUrl}}" ], "path": [ "spaces", "get", "nodes" ] }, "description": "Read-only. Like `spaces_state` but scoped to `nodeIds` + their connections. Cheaper than full board. Needs view perm.", "body": { "mode": "raw", "raw": "{\n \"spaceId\": \"\",\n \"nodeIds\": \"\",\n \"currentPageId\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_spaces_list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spaces/list", "host": [ "{{baseUrl}}" ], "path": [ "spaces", "list" ] }, "description": "Lean spaces catalog as raw TOON text. Share each `webUrl`; call `spaces_show` only for inline canvas preview. Do not use `creations_search`.", "body": { "mode": "raw", "raw": "{\n \"query\": \"\",\n \"ownership\": \"\",\n \"page\": 0,\n \"perPage\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_spaces_run", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spaces/run", "host": [ "{{baseUrl}}" ], "path": [ "spaces", "run" ] }, "description": "Run Space workflow from `startNodeId`. Modes: singular, connected default, downstream. Poll with `spaces_run_status`.", "body": { "mode": "raw", "raw": "{\n \"spaceId\": \"\",\n \"startNodeId\": \"\",\n \"mode\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_spaces_run_status", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spaces/run/status", "host": [ "{{baseUrl}}" ], "path": [ "spaces", "run", "status" ] }, "description": "Poll `spaces_run`. `timeoutSeconds` long-polls up to 25s. In-progress returns `poll_after_seconds`; terminal call `creations_show`.", "body": { "mode": "raw", "raw": "{\n \"workflowRunIdentifier\": \"\",\n \"timeoutSeconds\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_spaces_state", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spaces/state", "host": [ "{{baseUrl}}" ], "path": [ "spaces", "state" ] }, "description": "Read-only board context, raw TOON. Default: current page + pageIndex (other pages, counts). pageId: another page on demand. scope=all: whole board (costly). selectedElementIds: selected nodes. Needs v", "body": { "mode": "raw", "raw": "{\n \"spaceId\": \"\",\n \"selectedElementIds\": \"\",\n \"selectedConnectionIds\": \"\",\n \"currentPageId\": \"\",\n \"pageId\": \"\",\n \"scope\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_stock_download", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/stock/download", "host": [ "{{baseUrl}}" ], "path": [ "stock", "download" ] }, "description": "Signed download URL for a stock item. Pass folder_reference to also save as a creation (rate-limited).", "body": { "mode": "raw", "raw": "{\n \"id\": 0,\n \"type\": \"\",\n \"folder_reference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_stock_get", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/stock/get", "host": [ "{{baseUrl}}" ], "path": [ "stock", "get" ] }, "description": "Full details for a single Freepik stock item: preview URL, dimensions, formats, author.", "body": { "mode": "raw", "raw": "{\n \"id\": 0,\n \"type\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_stock_search", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/stock/search", "host": [ "{{baseUrl}}" ], "path": [ "stock", "search" ] }, "description": "Search Freepik stock catalog by keyword. Returns items with IDs, titles, types, preview URLs. Use stock_get for full details, stock_download for file URL.", "body": { "mode": "raw", "raw": "{\n \"query\": \"\",\n \"content_type\": \"\",\n \"page\": 0,\n \"per_page\": 0\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_stock_to_creation", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/stock/to/creation", "host": [ "{{baseUrl}}" ], "path": [ "stock", "to", "creation" ] }, "description": "Convert Freepik stock item → Pikaso creation. Use after user selects from stock_show.", "body": { "mode": "raw", "raw": "{\n \"id\": 0,\n \"folder_reference\": \"\",\n \"title\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_video_concatenate", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/video/concatenate", "host": [ "{{baseUrl}}" ], "path": [ "video", "concatenate" ] }, "description": "Concatenate completed video creations into one MP4. Assembles multi-clip plans from `video_plan`. Audio from each clip; no external audio bed. Returns queued creation.", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"creationIdentifiers\": \"\",\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_video_generate", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/video/generate", "host": [ "{{baseUrl}}" ], "path": [ "video", "generate" ] }, "description": "Generate video. External clients: call `video_plan` first to draft the brief and resolve model choice — skip only if the user explicitly says \"just generate\" or \"one-shot\". Pick a model with `slug` (c", "body": { "mode": "raw", "raw": "{\n \"video\": {},\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_video_models_list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/video/models/list", "host": [ "{{baseUrl}}" ], "path": [ "video", "models", "list" ] }, "description": "Video-gen model catalog as lean TOON text. `search` filters by name, slug, description, or tags. Run `video_plan` first — plan resolves slug to validate here.", "body": { "mode": "raw", "raw": "{\n \"search\": \"\",\n \"onlyRecommended\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_video_plan", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/video/plan", "host": [ "{{baseUrl}}" ], "path": [ "video", "plan" ] }, "description": "Call FIRST for any video request. Returns markdown plan: brief, open questions, characters to prepare, recommended model slug, prompt draft. Videos >15s: plan splits into clips + `video_concatenate` i", "body": { "mode": "raw", "raw": "{\n \"prompt\": \"\",\n \"durationHint\": 0,\n \"styleHint\": \"\",\n \"aspectRatioHint\": \"\",\n \"referenceIdentifiers\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_video_speak", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/video/speak", "host": [ "{{baseUrl}}" ], "path": [ "video", "speak" ] }, "description": "Make a character speak. Image+audio → talking head (Veed Fabric 1.0). Video+audio → lip sync (Lipsync 2.0). Omit `mode` for auto. Pass asset URLs or a creation `identifier` (from `audio_tts`, `images_", "body": { "mode": "raw", "raw": "{\n \"audioUrl\": \"\",\n \"videoUrl\": \"\",\n \"imageUrl\": \"\",\n \"mode\": \"\",\n \"resolution\": \"\",\n \"prompt\": \"\",\n \"voiceId\": 0,\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_video_upscale", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/video/upscale", "host": [ "{{baseUrl}}" ], "path": [ "video", "upscale" ] }, "description": "Upscale video via Topaz or Magnific. Pass `creationIdentifier` or Freepik `videoUrl`. Params: `video_upscale_models_list`. Then call `creations_show`.", "body": { "mode": "raw", "raw": "{\n \"creationIdentifier\": \"\",\n \"videoUrl\": \"\",\n \"mode\": \"\",\n \"upscaleFactor\": 0,\n \"targetFps\": 0,\n \"targetResolution\": 0,\n \"focus\": 0,\n \"sharpen\": 0,\n \"enhancementModel\": \"\",\n \"frameInterpolation\": \"\",\n \"creativity\": 0,\n \"magnificResolution\": \"\",\n \"premiumQuality\": false,\n \"fpsBoost\": false,\n \"smartGrain\": 0,\n \"flavor\": \"\",\n \"turbo\": false,\n \"preview\": false,\n \"strength\": 0,\n \"folderReference\": \"\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "magnific_video_upscale_models_list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/video/upscale/models/list", "host": [ "{{baseUrl}}" ], "path": [ "video", "upscale", "models", "list" ] }, "description": "Video upscale mode catalog as raw TOON text (topaz, magnific, magnific_precision) with required/optional params, ranges and enums. Read before calling `video_upscale`.", "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } } } ] }