List all models

curl --request GET \
  --url https://api.magica.com/api/v1/models \
  --header 'Authorization: <authorization>'

{
  "(array)": [
    {
      "nodeType": "<string>",
      "name": "<string>",
      "description": "<string>",
      "category": "<string>",
      "icon": "<string>",
      "accent": "<string>",
      "subModels": [
        {
          "subModelId": "<string>",
          "label": "<string>",
          "category": "<string>"
        }
      ]
    }
  ]
}

GET

models

List all models

curl --request GET \
  --url https://api.magica.com/api/v1/models \
  --header 'Authorization: <authorization>'

{
  "(array)": [
    {
      "nodeType": "<string>",
      "name": "<string>",
      "description": "<string>",
      "category": "<string>",
      "icon": "<string>",
      "accent": "<string>",
      "subModels": [
        {
          "subModelId": "<string>",
          "label": "<string>",
          "category": "<string>"
        }
      ]
    }
  ]
}

Returns a single array containing every model the platform exposes — image, video, audio, LLM, and utility. Each entry surfaces the nodeType and any subModels for multi-mode models.

Need the response grouped by category with role labels (GENERATE / EDIT / TRANSFORM)? Use GET /v1/models/search instead. This endpoint is intentionally flat — best when you just want to enumerate every model ID.

Authorizations

Authorization

string

required

Bearer API key. Format: Bearer gx_your_api_key.

Response

(array)

array

Array of model entries — one per registered node type.

Show Each entry

nodeType

string

Stable identifier used as {nodeType} in POST /v1/nodes/{nodeType}/run, node-shaped estimate payloads, and single-mode model schema lookups (e.g. nano_banana_pro, flux_2_max, kling_v3_pro).

name

string

Human-readable display name.

description

string

Short description shown in pickers.

Request

cURL
Node.js
Python

curl https://api.magica.com/api/v1/models \
  -H "Authorization: Bearer $MAGICA_API_KEY"

const res = await fetch("https://api.magica.com/api/v1/models", {
  headers: { Authorization: `Bearer ${process.env.MAGICA_API_KEY}` },
});
const models = await res.json();

// Every nodeType you can use in /v1/nodes/{nodeType}/run
const nodeTypes = models.map((m) => m.nodeType);

// Every modelId you can pass to /v1/models/{modelId}/schema
const modelIds = models.flatMap((m) =>
  m.subModels ? m.subModels.map((sm) => sm.subModelId) : [m.nodeType],
);

import os, requests

res = requests.get(
    "https://api.magica.com/api/v1/models",
    headers={"Authorization": f"Bearer {os.environ['MAGICA_API_KEY']}"},
)
models = res.json()

for m in models:
    if m.get("subModels"):
        for sm in m["subModels"]:
            print(f"{m['nodeType']:30}  {sm['subModelId']:30}  {sm['label']}")
    else:
        print(f"{m['nodeType']:30}  -")

Response example

Truncated to two entries (the live response includes ~80 models):

[
  {
    "nodeType": "flux_2_max",
    "name": "FLUX 2 Max",
    "description": "State-of-the-art image generation with exceptional realism, precision, and consistency",
    "category": "image",
    "icon": "image",
    "accent": "blue",
    "subModels": [
      {
        "subModelId": "flux-2-max-text",
        "label": "Text to Image",
        "category": "text-to-image"
      },
      {
        "subModelId": "flux-2-max-edit",
        "label": "Image to Image",
        "category": "image-to-image"
      }
    ]
  },
  {
    "nodeType": "kling_v3_pro",
    "name": "Kling v3 Pro",
    "description": "Text-to-video and image-to-video.",
    "category": "video",
    "icon": "video",
    "accent": "pink"
  }
]

What the IDs are for

Field	Use it where
`nodeType`	Path param in `POST /v1/nodes/{nodeType}/run`; also use as `nodeType` in `POST /v1/nodes/estimate-credits`
`subModels[].subModelId`	Path param in `GET /v1/models/{modelId}/schema` and `GET /v1/models/{modelId}/pricing`; also pass as `subModelId` when running a multi-mode model

For single-mode models (no subModels), the schema endpoint accepts the nodeType directly.

Errors

Status	Reason
`401`	Missing or invalid API key
`500`	Server error

Estimate workflow credits Get model catalog

​Authorizations

​Response

​Request

​Response example

​What the IDs are for

​Errors

Authorizations

Response

Request

Response example

What the IDs are for

Errors