Kinoseed

Guide

FLUX.2 API: price per image, request and code

FLUX.2 API price per image and per batch: the model id, the request, the MCP call, reference images, and how it compares with FLUX 3 on price.

The FLUX.2 API on Kinoseed is one REST call, or one MCP tool call, with the model id flux-2. As of 15 Nov 2026, one image on FLUX.2 (flux-2) is 7 credits ($0.14). Quote the request without charge with POST /api/v1/quote, start it with POST /api/v1/images, then read the job until it holds the image URLs; it finishes in seconds.

Generating begins with a plan from $10 a month (500 credits a month). Every tool page is open to browse without an account. The key comes from your account page, and the same credits pay for the web app, the REST API and the MCP server. This guide gives the price per image and per batch, the request, the MCP call an agent sends, and when FLUX.2 is the right pick.

Sign in, create a key on your account page, and call any model with one key.

What a FLUX.2 image costs

Credits per run from a prompt, for one image and for 4, and for one image with one reference image. Dollars are at the headline credit price; plans with more credits pay less per credit.

Model1 image4 images1 image with a reference
FLUX.2 (flux-2)7 credits ($0.14)25 credits ($0.50)7 credits ($0.14)
FLUX 3 (flux-3)10 credits ($0.20)40 credits ($0.80)10 credits ($0.20)
FLUX 3 Klein (flux-3-klein)3 credits ($0.06)8 credits ($0.16)3 credits ($0.06)

Computed from the quote the API charges with, as of 15 Nov 2026. The price is the same for every aspect ratio.

One request, then read the job

POST /api/v1/images charges the run and answers with a 201 job in queued or running. Read GET /api/v1/jobs/{id}?wait=50: it holds the line for up to 50 seconds and returns the moment the job is final, with the URLs in output.imageUrls. The body below is the cheapest valid FLUX.2 request, one square image, which costs 7 credits.

curl -X POST https://kinoseed.app/api/v1/images \
  -H "Authorization: Bearer ks_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a ceramic mug on a sunlit desk, product photo",
    "model": "flux-2",
    "aspect": "1:1",
    "count": 1
  }'

Send the same body to Quote first if you want the number before you spend anything; it charges nothing. Fields and errors are on Images and Jobs.

The same run from an agent over MCP

An agent connected to the MCP server sends the same arguments to the generate_image tool, which waits for the run and returns the image URLs. Results are URLs, never inline base64, so a batch of pictures does not fill the context window. Setup for Claude Code, Cursor and others is in the MCP server for image generation guide.

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_image",
    "arguments": {
      "prompt": "a ceramic mug on a sunlit desk, product photo",
      "model": "flux-2",
      "aspect": "1:1",
      "count": 1
    }
  }
}

What FLUX.2 accepts

Every field is optional except prompt. Without model the run uses the catalog default, so send the id you want.

  • aspect: a ratio such as 16:9 or 9:16; 1:1 when it is left out.
  • count: 1 to 8 images in one run; the price multiplies.
  • referenceImageUrls: up to eight pictures to edit or follow, as public https URLs or URLs from POST /files.
  • seed: a whole number, to repeat a result.
  • metadata: your own ids, returned on the job untouched.

On FLUX.2 a run with a reference image runs on the same endpoint as a prompt and costs the same.

The API refuses private addresses, localhost and plain http in referenceImageUrls before anything fetches them or anything is charged.

What moves the price

The model and the number of images. The aspect ratio does not change it. 4 images on FLUX.2 in one run are 25 credits.

For drafts, a cheaper model often does the job: one FLUX 3 Klein image is 3 credits. Test the prompt there, then run the keeper on FLUX.2. Every image model's price is side by side in Image generation API with credits.

When to pick FLUX.2

Pick FLUX.2 for detailed pictures at a low price per image: product shots, scenes, social images where a batch of options is worth more than one perfect take. Studio users get it in the Image studio; the FLUX.2 model page has its price and specs, and how to use FLUX.2 covers prompts.

For Black Forest Labs' newest model, see the FLUX 3 API guide.

Side by side with the models people weigh it against: FLUX.2 vs Nano Banana Pro, FLUX.2 vs GPT Image 2, FLUX 3 vs FLUX.2, Grok Imagine vs FLUX.2, Z-Image vs FLUX.2, Seedream 5.0 · Lite vs FLUX.2.

Failures, retries and limits

A run that fails is refunded automatically, and the job says so, so a provider error never costs credits. Identical requests sent close together return the same job instead of charging twice, and an Idempotency-Key header makes that explicit for retries from your own code.

An account runs up to 5 generations at once; one more gets a 429 too_many_running error with a Retry-After header, before anything is charged. Results carry no watermark. Rate limits and error codes are on Errors and Rate limits.

Questions

How much does the FLUX.2 API cost per image?

7 credits ($0.14) for one FLUX.2 image, as of 15 Nov 2026. A run of 4 costs 25 on FLUX.2.

What is the model id for FLUX.2?

flux-2 for FLUX.2. Send it as model in POST /api/v1/images, or as the model argument of the generate_image MCP tool. GET /api/v1/models lists every id with an example price.

Do I need a subscription to use the API?

Generating begins with a plan from $10 a month (500 credits a month). Every tool page is open to browse without an account. There is no separate API plan: the key spends the same credits as the web app, and unused credits roll over.

Does a reference image cost more?

Not on FLUX.2: 7 credits with or without one.

Is this Black Forest Labs' own API?

No. Kinoseed runs FLUX.2 through fal, its provider, and sells it in credits with a quote before every run, automatic refunds on failure and an MCP server on top.

Sign in, create a key on your account page, and call any model with one key.