Skip to main content
POST
/
v1
/
nodes
/
{nodeType}
/
run
Run a model
curl --request POST \
  --url https://api.magica.com/api/v1/nodes/{nodeType}/run \
  --header 'Authorization: Bearer <token>'
Use this endpoint to execute one model directly. The response returns a runId; poll GET /v1/nodes/runs/{runId} for status and output. For multi-mode models, pass subModelId in the JSON body. Discover valid model and sub-model IDs with GET /v1/models, GET /v1/models/search, and GET /v1/models/{modelId}/schema. 
curl -X POST https://api.magica.com/api/v1/nodes/flux_2_max/run \
  -H "Authorization: Bearer $MAGICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subModelId": "flux-2-max-text",
    "input": {
      "prompt": "A cinematic product photo of a glass speaker"
    }
  }'