FLUX 2 Max Image API and MCP for AI agents
TollNode gives Claude, Cursor or any AI agent FLUX 2 Max, Black Forest Labs' highest-fidelity image model, over API and MCP, from $0.076 per image, with no subscription.
Ask for 'a close-up portrait of an elderly watchmaker at his workbench, loupe in one eye, warm desk lamp, shallow depth of field' and get a finished image link back.
No subscription · Sign-up optional · From $0.076 per call · Charged only when it works · No Black Forest Labs account needed
Generate a close-up portrait of an elderly watchmaker at his workbench, loupe in one eye, tiny gears and tweezers on the bench, warm desk lamp, shallow depth of field, 1 MP, 4:5
TollNode · Black Forest Labs · 1 MP$0.096 · 1 image
| Result | Detail |
|---|---|
| File | 1 image link, does not expire |
| Resolution | 1 MP |
| Aspect ratio | 4:5 |
Real result, shown below.
FLUX 2 Max image examples
Made by this node in our own tests, from the request shown under each.

“Close-up portrait of an elderly watchmaker at his workbench, loupe in one eye, tiny gears and tweezers on the bench, warm desk lamp, shallow depth of field”
The request that made it
Send the same body to get this kind of result. Change the prompt or the options to get your own.
{
"prompt": "Close-up portrait of an elderly watchmaker at his workbench, loupe in one eye, tiny gears and tweezers on the bench, warm desk lamp, shallow depth of field",
"resolution": "1 MP",
"aspect_ratio": "4:5"
}What you control with FLUX 2 Max
Prompt and style
FLUX 2 Max prompt to image
Describe the photo or scene in plain words.
- Prompt
- Close-up portrait of an elderly watchmaker at his workbench, loupe in one eye...
- Aspect ratio
- 4:5
- Returns
- 1 image link
You get
- prompt: what to create, up to 2,000 characters
- aspect_ratio: 9 fixed ratios from 1:1 to 16:9
- output_format: webp, jpg or png
- from $0.076
Resolution and price
0.5 to 4 megapixel output
Pick the megapixel size; price follows it.
- Default
- 1 MP
- Resolution
- 1 MP
- Highest
- 4 MP, highest detail
You get
- resolution: 0.5 to 4 megapixels, sets price
- seed: fix a number to repeat a look
Format and seed
File format and repeatable results
Choose the file type and lock a seed for consistency.
- Output format
- webp, jpg or png (optional)
- Seed
- optional integer
- Returns
- 1 image link
You get
- output_format: webp, jpg or png
- seed: integer to reproduce the same image
Failed calls are never charged, and image links returned by TollNode don't expire.
What people ask their AI to do with it
Photographers
Photoreal portrait concepts without a shoot
“Create a close-up portrait of a street musician playing violin at dusk, neon signs reflected in rain puddles, 1 MP, 4:5”
1 MP
Cost today$0.096
Marketers
Photoreal ad visuals for campaigns
“Generate a 16:9 ad image of a runner lacing up shoes on a city rooftop at sunrise, 2 MP”
2 MP
Cost today$0.136
Authors and publishers
Book cover art from a scene description
“Make a 2:3 book cover image of a lighthouse keeper staring out at a storm, moody and photoreal, 2 MP”
2 MP
Cost today$0.136
Game developers
Concept art for characters and environments
“Draw a weathered mercenary standing in a ruined desert outpost, late afternoon light, 1 MP, 3:4”
1 MP
Cost today$0.096
Architects
Photoreal renders of building concepts
“Render a glass and timber house on a forested hillside at golden hour, 4 MP, 16:9”
4 MP
Cost today$0.217
Ecommerce sellers
Product photos without a shoot
“Show a leather wallet on a rustic wooden table with soft window light, 2 MP, 1:1”
2 MP
Cost today$0.136
Use it as a FLUX 2 Max MCP server in Claude, Cursor or Codex
Connect once. Then just ask.
Paste this into Claude Code, Cursor or Codex. It connects TollNode and gives your agent a small wallet. Add a few dollars of USDC and you're done.
npx agentcash add https://tollnode.comCopy for your AI agent
Paste this into your agent so it knows what this node does and how to call it.
You can use TollNode's FLUX 2 Max node to generate photoreal images from text. Call POST https://tollnode.com/api/v1/nodes/flux-2-max with prompt (required, up to 2,000 characters), resolution (0.5 MP, 1 MP, 2 MP or 4 MP, default 1 MP), aspect_ratio (9 ratios from 1:1 to 16:9, default 1:1), output_format (webp, jpg or png) and seed (optional integer to reproduce a result). The price depends on resolution and is charged only when an image is returned. Over MCP, call the "flux-2-max" tool; use list_models to see prices. Give me the image link when it is done.Price
from $0.076
per image
The price depends on the resolution you choose. If you don't choose, you get 1 MP.
| 0.5 MP | $0.076 per image |
| 1 MPdefault | $0.096 per image |
| 2 MP | $0.136 per image |
| 4 MP | $0.217 per image |
Charged only when a call returns a result. Failed or empty calls cost $0.
FLUX 2 Max without a Black Forest Labs account
No subscription, no credit packs
Pay per image: $0.076 at 0.5 MP, $0.096 at 1 MP, $0.136 at 2 MP, $0.217 at 4 MP.
No Black Forest Labs account, no setup
Your agent calls TollNode directly. You never register for API access.
Only charged when it works
If generation fails or returns nothing, the call costs nothing.
One connection, many image models
The same setup also gives your agent Nano Banana Pro, Seedream and others, so it can compare results.
FAQ
- Is this the official Black Forest Labs API?
- No. TollNode is an independent service. It gives your agent access to FLUX 2 Max through its own API and MCP server, priced per image, with no Black Forest Labs account needed.
- Can I use it as a FLUX 2 Max MCP server in Claude?
- Yes. Add https://tollnode.com/mcp in Claude Code, Claude Desktop or Cursor, and the "flux-2-max" tool appears with its options and prices.
- What resolutions can I get?
- 0.5, 1, 2 or 4 megapixels. The resolution you pick sets the price, and 1 MP is the default if you don't specify one.
- Can I control the aspect ratio and file format?
- Yes. Pick from 9 fixed ratios from 1:1 to 16:9, and choose webp, jpg or png for the output file.
- Can I get the same image again later?
- Set a seed value and reuse it with the same prompt and settings to reproduce the same result.
- What if no image comes back?
- You're not charged. TollNode only collects payment when a usable image is returned.
- How long are the image links valid?
- They don't expire. Download the file or keep the link.
Works well with
- FLUX 2 Pro image generationTry the same prompt on a lower-cost FLUX 2 tierfrom $0.032
- FLUX Kontext Max image editingEdit a finished FLUX 2 Max image with text instructions$0.109
- Crisp image upscalerEnlarge a finished image for print$0.010
- Veo 3.1 video with soundTurn a finished image into a short video with soundfrom $2.161
Ready in a minute
Connect your AIFor developers: endpoint, inputs and an example response
POST https://tollnode.com/api/v1/nodes/flux-2-max
Input
| Field | Type | Notes |
|---|---|---|
| seed | integer | |
| prompt* | string | What to create or change |
| resolution | enum | Output size in megapixels; sets the price. Default 1 MP (0.5 MP, 1 MP, 2 MP, 4 MP) |
| aspect_ratio | enum | Aspect ratio, default 1:1 (1:1, 16:9, 3:2, 2:3, 4:5, 5:4, 9:16, 3:4, 4:3) |
| output_format | enum | (webp, jpg, png) |
Example response
{
"images": [
"https://tollnode.com/api/v1/files/00000000-0000-0000-0000-000000000000/0"
]
}Also described in the OpenAPI file and llms.txt. Setup for every app: Agents & MCP.