Estimate workflow credits

curl --request POST \
  --url https://api.magica.com/api/v1/workflows/estimate-credits \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nodes": [
    {
      "type": "<string>",
      "data": {},
      "subModelId": "<string>"
    }
  ]
}
'

{
  "totalMicrocredits": 123,
  "estimates": [
    {
      "microcredits": 123
    }
  ]
}

POST

workflows

estimate-credits

Estimate workflow credits

curl --request POST \
  --url https://api.magica.com/api/v1/workflows/estimate-credits \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nodes": [
    {
      "type": "<string>",
      "data": {},
      "subModelId": "<string>"
    }
  ]
}
'

{
  "totalMicrocredits": 123,
  "estimates": [
    {
      "microcredits": 123
    }
  ]
}

Returns the total microcredit cost of a workflow run, along with a per-node breakdown so you can render the same number on a workflow summary and on individual node cards.

Uses the same pricing engine as POST /v1/nodes/estimate-credits — the response guarantees totalMicrocredits === sum(estimates[].microcredits) by construction.

Authorizations

Authorization

string

required

Bearer API key. Format: Bearer gx_your_api_key.

Body

nodes

array

required

Array of node configurations that make up the workflow. Capped at the per-workflow node limit enforced by the workflow editor.

Show Each node

type

string

required

Node type identifier (e.g. flux_2_pro, nano_banana_pro, gpt_5_4).

data

object

Input values for the node, keyed by input field name.

subModelId

string

Active sub-model identifier for multi-mode nodes.

Response

totalMicrocredits

number

Total cost of running the whole workflow. Equals the sum of estimates[].microcredits.

estimates

array

Per-node breakdown, in input order.

Show Each estimate

microcredits

number

Cost contributed by that node, in microcredits.

Request

cURL
Node.js
Python

curl -X POST https://api.magica.com/api/v1/workflows/estimate-credits \
  -H "Authorization: Bearer $MAGICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "nodes": [
      { "type": "flux_2_pro", "data": { "prompt": "A red Ferrari" } },
      { "type": "gpt_5_4",    "data": { "prompt": "Describe this" } }
    ]
  }'

const res = await fetch(
  "https://api.magica.com/api/v1/workflows/estimate-credits",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.MAGICA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      nodes: [
        { type: "flux_2_pro", data: { prompt: "A red Ferrari" } },
        { type: "gpt_5_4",    data: { prompt: "Describe this" } },
      ],
    }),
  },
);
const { totalMicrocredits, estimates } = await res.json();

import os, requests

res = requests.post(
    "https://api.magica.com/api/v1/workflows/estimate-credits",
    headers={
        "Authorization": f"Bearer {os.environ['MAGICA_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "nodes": [
            {"type": "flux_2_pro", "data": {"prompt": "A red Ferrari"}},
            {"type": "gpt_5_4",    "data": {"prompt": "Describe this"}},
        ]
    },
)
payload = res.json()
print(payload["totalMicrocredits"], payload["estimates"])

Response example

{
  "totalMicrocredits": 3700000,
  "estimates": [{ "microcredits": 2500000 }, { "microcredits": 1200000 }]
}

Errors

Status	Reason
`400`	Invalid body, exceeds max nodes per workflow, or unparseable JSON
`401`	Missing or invalid API key
`500`	Pricing engine failure

Remove an edge between nodes List all models

​Authorizations

​Body

​Response

​Request

​Response example

​Errors

Authorizations

Body

Response

Request

Response example

Errors