Skip to main content

Visual AI Pipelines

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

​
Key capabilities

  • Dynamic inputs: Each Flow 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: Flows can produce images, videos, or audio depending on the workflow

​
How it works

  1. List flows to discover available workflows
  2. Get flow details to see required inputs and their types
  3. Run the flow by providing values for each input, keyed by its api_key (recommended) or id (legacy)
  4. Poll or webhook to get the results when execution completes

GET /v1/ai/flows

List all available flows

GET /v1/ai/me/flows

List flows you own, including drafts

GET /v1/ai/flows/{flow-id}

Get a flow definition and its inputs

POST /v1/ai/flows/{flow-id}/run

Run a flow with your inputs

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

Poll run status and results

​
Input types

​
Example: Run a flow

​
Identifiers

Flows are identified by their SQID:
Existing integrations that call the legacy /v1/ai/apps paths remain functional. New integrations should use the /v1/ai/flows endpoints documented here.

​
More about Spaces

Magnific Spaces — node-based AI workflow canvas
 Magnific Spaces is the infinite canvas where you build and publish Flows. 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 a Flow to make it available via this API.

Open Magnific Spaces

Start building your own AI workflows on the infinite canvas.

Manage your Flows

View your published Flows and copy their IDs to use with this API.

​
Frequently Asked Questions

Flows 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/flows/{flow-id} to get the full definition, including all required inputs with their types and labels. Use each input’s api_key field (recommended) — a human-friendly identifier matching the node name — as the key in the inputs object when running the flow. The UUID-based id field is still accepted for backward compatibility (legacy).
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 flow shows its credit cost in the tool_metadata.total_cost field. See the Pricing page for credit rates.