Annual Sale!Get 30% offClaim Now→

Flux1 AI Logo

Developer API · v1 live

Every model. One API key.

Generate with the Nano Banana family today; Veo 3.1 and Seedream 5 join the same endpoint next, then the rest of the Flux1 AI catalog. One request shape, billed with the credits you already have.

Create an API keyRead the docs

Included with every paid plan and credit pack. Sign in to create a key.

Already generating in the app? Your credits carry over. Every request is logged under Settings → API Logs.

curl https://flux1.ai/api/v1/generations \
  -H "Authorization: Bearer $FLUX1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "product photo of a ceramic mug, soft daylight",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }'

What you get

Built for the code you already write

One request shape for every model

Nano Banana, Nano Banana Pro, Nano Banana 2 and 2 Lite are live today. Veo 3.1 and Seedream 5 join the same endpoint next, then the rest of the catalog: swap the model id, keep the code.

Same credits as the app

API calls draw from the credit balance you already have, at the same per-model price you see in the generator. No separate API plan, no second invoice; failed generations are refunded.

Async jobs, simple polling

Submit a generation and get an id back immediately. Poll it every few seconds until the file is ready on a CDN URL; most images finish in 10 to 20 seconds.

Model catalog

Live today, and what joins next

Seedream 5.0 Lite and the Nano Banana family share one generation endpoint. Open a model reference for its parameters and examples; GET /v1/models always returns the current list with prices.

Coming to the API · already in the app

How it works

Three steps to your first generation

  1. 01

    Pick a plan

    Any paid plan or credit pack includes the API. There is no separate API plan: the credits you already have are the credits the API spends.

  2. 02

    Create a key

    Open Settings → API Keys and create one. The key is shown once, so store it on your server. Up to 5 active keys per account, revocable any time.

  3. 03

    Ship

    Plain REST with JSON. Copy the sample above, poll the id it returns, download the file. Every request, including rejected ones, shows up under Settings → API Logs.

Questions

What does the API cost?

The same credits as the web app, at the same per-model price: Nano Banana from 6 credits an image, Nano Banana 2 from 10. There is no separate API subscription, and failed generations are refunded automatically.

Which models are included?

9 image models today: seedance-2, seedance-2-fast, seedance-2-mini, veo-3-1, seedream-5, nano-banana, nano-banana-pro, nano-banana-2, nano-banana-2-lite. Veo 3.1 and Veo 3.1 Lite for video come next, then Seedream 5 and 5.0 Pro. GET /v1/models always returns the live list with prices and options.

How do I get access?

Buy any plan or credit pack, then create a key under Settings → API Keys. Free and gifted credits do not unlock the API. Accounts that abuse the API can be disabled.

Are there webhooks?

Not in v1. Poll GET /v1/generations/{id} every 2 to 3 seconds; the response carries the status, the output URLs and whether credits were refunded. An Idempotency-Key header for safe retries is on the roadmap.

Is there an SDK?

The API is plain REST over HTTPS with JSON bodies, so it works from any language. The docs include complete cURL, Node.js and Python examples that submit and poll a generation.

Your key is one click away.

Create it in Settings, paste it into the sample above, and the first generation is billed like any other in your account.

Create an API keyRead the docs

Included with every paid plan and credit pack. Sign in to create a key.