Flux1 AIDevelopers
Flux1 AI API docs

Flux1 AI API

Build with Seedream and Nano Banana. Generate images, edit with references, and track every request through one API.

  • Base URL https://flux1.ai/api/v1
  • Authentication Authorization: Bearer fx1_live_…
  • Format JSON request bodies, JSON responses

Image models

Choose a model for its complete parameter reference, credit prices and ready-to-copy cURL, Node.js and Python examples.

How it works

Every generation is asynchronous. POST /v1/generations validates the request, charges the credits for it, hands the job to the model provider and returns 202 Accepted with a generation id. You then GET /v1/generations/{id} until status leaves queued. There are no webhooks in v1; polling every 2–3 seconds is the expected pattern.

Credits are shared with the web app: the same balance and per-model prices. Pre-debit rejections cost nothing; check credits_refunded to confirm a refund. Uncertain submissions may require review. Use Idempotency-Key for retries. Persisted image tasks also appear in My Images.

API access requires administrator approval. Buying credits does not automatically enable it. Approved accounts can create keys at Settings → API Keys.

Where to start