Skip to main content
This API is available exclusively for Enterprise customers.

Visual AI Pipelines

Execute multi-step AI workflows with a single API call. Each app chains together AI tools into a reusable pipeline.
Apps are visual AI pipelines created in Magnific Spaces. Each app chains together multiple AI tools (upscale, generate, edit, transform, etc.) into a reusable workflow. Once published, apps can be executed programmatically via this API — you provide the required inputs (images, text prompts, etc.) and the app runs the entire pipeline, returning the final output.

​
Key capabilities

  • Dynamic inputs: Each app defines its own inputs — images, text prompts, numbers, or selections
  • Async execution: Submit a run, then poll for status or receive a webhook notification
  • Multi-output: Apps can produce images, videos, or audio depending on the workflow

​
How it works

  1. List apps to discover available workflows
  2. Get app details to see required inputs and their types
  3. Run the app by providing values for each input id
  4. Poll or webhook to get the results when execution completes

GET /v1/ai/apps

List all available workflow apps

GET /v1/ai/apps/{app-id}

Get app definition and inputs

POST /v1/ai/apps/{app-id}/run

Execute a workflow app

GET /v1/ai/apps/runs/{run-id}

Poll run status and results

​
Input types

Input TypeAccepted ValuesExample
creationImage URL, base64-encoded image, or creation identifier"https://example.com/photo.jpg"
textPlain text string"A car in the forest"
numberNumeric value0.5
selectValue from predefined options"style_a"

​
Example: Run an app

curl -X POST "https://api.magnific.com/v1/ai/apps/uqzQLDr2Aw/run" \
  -H "X-Magnific-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "input-4050c3f3-8a26-4953-97a8-cb97bceb4816-1": "https://example.com/my-sketch.jpg"
    },
    "webhook": "https://your-server.com/webhook"
  }'

​
Identifiers

Apps are identified by their SQID:
FormatExampleDescription
SQIDuqzQLDr2AwShort unique identifier for each app

​
More about Spaces

Magnific Spaces — node-based AI workflow canvas
 Magnific Spaces is the infinite canvas where you build and publish apps. Connect AI nodes visually — image generation, upscaling, style transfer, text processing, and more — into reusable workflows. Collaborate with your team in real time, then publish your workflow as an app to make it available via this API.

Open Magnific Spaces

Start building your own AI workflows on the infinite canvas.

​
Frequently Asked Questions

Apps are visual AI pipelines built in Magnific Spaces. They chain together multiple AI tools (image generation, upscaling, style transfer, etc.) into a single reusable workflow. The API lets you execute these workflows programmatically.
Call GET /v1/ai/apps/{app-id} to get the full definition, including all required inputs with their types and labels. Use the id field as the identifier when running the app.
Execution time depends on the workflow complexity and the AI tools involved. Simple single-tool workflows may complete in 10-30 seconds. Multi-step workflows with video generation can take 1-5 minutes. Use webhooks for production integrations.
See the Rate Limits page for current limits by subscription tier.
Each app shows its credit cost in the tool_metadata.total_cost field. See the Pricing page for credit rates.