Want Flux images in your own app, script or automation? This guide shows how to make them with the AiWings API, step by step. Flux Fast is the lowest-cost image model on AiWings, so it’s ideal for drafts, thumbnails and high volume. You use one AiWings key, pay per image from your AiWings credits, and get back a permanent link to every file.
What you need
- An AiWings account. Sign in with Google; new accounts get 10 free credits, enough for 10 Flux Fast images.
- An AiWings API key, which you create in the next step.
- Somewhere to run code on a server: a script, a backend route, a serverless function or an automation tool that can send HTTP requests. Keys don’t work from browser or mobile app code, where anyone could read them.
Step 1: Create an API key
- 1Sign in to AiWings and open the API page in your dashboard.
- 2Click Create key, give it a name (for example “my-app production”) and, if you like, a monthly credit limit.
- 3Copy the key. It starts with aiw_live_ and is shown only once.
- 4Save it as an environment variable on the machine or service that will call the API.
export AIWINGS_API_KEY="aiw_live_your_key_here"The API uses the same credits as AiWings in ChatGPT, Claude and the dashboard, so there’s no separate plan to buy. Every request sends the key in the Authorization header as a Bearer token.
Step 2: Know your options
AiWings offers Flux Fast, Black Forest Labs’ draft-speed model. It makes text-to-image only, and is the lowest-cost image model on AiWings:
| Model | model value | Size | Reference images | Cost per image |
|---|---|---|---|---|
| Flux Fast | flux-fast | 1K | None (text only) | 1 credit ($0.01) |
Prices are at the top-up rate of $0.01 per credit, and plans include more credits per dollar. Each finished job reports exactly what it cost in its credits field, and GET /v1/models lists every price. Aspect ratios: 1:1, 16:9, 21:9, 3:2, 2:3, 4:5, 5:4, 3:4, 4:3, 9:16, 9:21.
Step 3: Make your first image
Send a POST request to /v1/images with a prompt and the model. With "wait": true you get the finished image back in the same call, usually within a few seconds. Each one costs 1 credit ($0.01):
1curl https://aiwings.io/api/v1/images \2-H "Authorization: Bearer $AIWINGS_API_KEY" \3-H "Content-Type: application/json" \4-d '{5"prompt": "A macro photo of a tiny garden made of brass gears and copper leaves, morning dew on the metal, shallow depth of field",6"model": "flux-fast",7"aspect_ratio": "3:2",8"wait": true9}'1011# Still "processing"? Ask again with the id:12curl "https://aiwings.io/api/v1/images/IMAGE_ID?wait=30" \13-H "Authorization: Bearer $AIWINGS_API_KEY"
With "wait": true the request holds until the image is ready, for up to 60 seconds, so most images come back in one call with status "succeeded". Higher quality settings can take longer; if the status is still "processing", the loop asks again with GET /v1/images/{id}?wait=30.
output.url is a permanent link to the file. If an image fails, status is "failed", error.message says why, and the credits are refunded automatically. Every image you make through the API also shows up in your AiWings library.
Step 4: Draft in Flux, finish in a bigger model
Because a Flux Fast image costs so little, it’s a cheap way to try ideas: run a batch of drafts, pick the one you like, then send the same prompt to a model with more detail or reference images. Only the model field changes:
Draft: "model": "flux-fast" (1 credit ($0.01) per image)
Final: "model": "gpt-image-2.6-sunburst", "quality": "high" (16 credits ($0.16) per image)Flux Fast is text-only. To edit an image or keep a product the same, use Seedream or GPT Image, which take reference images.
See what Flux makes
Real, unedited Flux Fast images, each made from a single request.




More models with the same key
Your key isn’t limited to Flux. The same key, balance and request format cover every video and image model on AiWings. To switch, change the model field: video models go to POST /v1/videos and image models to POST /v1/images.
| Model | model value | Endpoint | From |
|---|---|---|---|
| Seedance 2.0 | seedance-2.0 | /v1/videos | 50 credits ($0.50) for 5 seconds at 480p |
| Seedance 2.5 | seedance-2.5 | /v1/videos | 65 credits ($0.65) for 5 seconds at 480p |
| MiniMax H3 | minimax-h3 | /v1/videos | 50 credits ($0.50) for 5 seconds at 768p |
| MiniMax H3 Highspeed | minimax-h3-highspeed | /v1/videos | 20 credits ($0.20) for 5 seconds at 768p |
| MiniMax H3 Lite | minimax-h3-lite | /v1/videos | 10 credits ($0.10) for 5 seconds at 480p |
| GPT Image 2.6 Flare | gpt-image-2.6-flare | /v1/images | 7 credits ($0.07) per image |
| GPT Image 2.6 Sunburst | gpt-image-2.6-sunburst | /v1/images | 7 credits ($0.07) per image |
| GPT Image 2.5 Flare | gpt-image-2.5-flare | /v1/images | 2 credits ($0.02) per image |
| GPT Image 2.5 Sunburst | gpt-image-2.5-sunburst | /v1/images | 2 credits ($0.02) per image |
| GPT Image 2 | gpt-image-2 | /v1/images | 2 credits ($0.02) per image |
| GPT Image 1.5 | gpt-image-1.5 | /v1/images | 2 credits ($0.02) per image |
| Nano Banana | nano-banana | /v1/images | 5 credits ($0.05) per image |
| Nano Banana 2 | nano-banana-2 | /v1/images | 8 credits ($0.08) per image |
| Nano Banana Pro | nano-banana-pro | /v1/images | 19 credits ($0.19) per image |
| Seedream 5 Lite | seedream-5-lite | /v1/images | 5 credits ($0.05) per image |
| Grok Imagine | grok-imagine | /v1/images | 3 credits ($0.03) per image |
| Flux Fast | flux-fast | /v1/images | 1 credit ($0.01) per image |
GET /v1/models returns the same list with every price, size and option, so your code can check what’s available instead of hard-coding it.
Things to know
- Flux Fast makes 1K images from text only, so reference_images and source_generation_id aren’t accepted.
- It supports very wide and very tall shapes, 21:9 and 9:21, for banners and phone wallpapers.
- At one credit per image you can afford to generate several options and pick the best one in your own code.
- Send an Idempotency-Key header with each new job (the JavaScript and Python examples do). If a request times out and you retry with the same key, you get the same job back instead of paying twice.
- Each key has its own rate limit, and you can give each key a monthly credit cap so a bug in one app can’t spend your whole balance.
- Output URLs are public but unguessable, like a share link. Download the file to your own storage if you need to control who can see it.
If something goes wrong
- 401 authentication_failed: the key is missing, mistyped or revoked. Check the Authorization header reads Bearer followed by your key.
- 400 invalid_request: a field isn’t allowed for that model, for example a quality or aspect ratio it doesn’t support. The error’s param names the field to fix.
- 402 insufficient_credits: your balance can’t cover the image. Top up in the dashboard and send the request again.
- 403 spend_limit_reached: this key hit its monthly credit limit. Raise or remove the limit on the API page.
- 429 rate_limited or too_many_jobs: you’re sending too fast or have too many jobs rendering at once. Wait for the Retry-After time, or for a image to finish.
- The image failed with a content error: the prompt or image was blocked by the model’s safety filter. Reword it; the credits were already refunded.
Bottom line
You don’t need a separate Black Forest Labs account to put Flux in your product. One AiWings key gives your code Flux Fast at one credit an image, plus GPT Image, Nano Banana, Seedream and video models, billed from one balance, with permanent links and automatic refunds on failures.
FAQ
Is this the official Flux API?
No. AiWings is an independent service that runs Flux for you. You use an AiWings key and AiWings credits, with no Black Forest Labs account or separate billing.
How much does a Flux image cost through the API?
1 credit ($0.01) per image, the lowest price of any image model on AiWings. Failed images are refunded.
Which Flux model is available?
Flux Fast, the draft-speed version. For more detail or edits from reference images, the same key also covers GPT Image, Nano Banana and Seedream.
Can I use it from n8n, Make or Zapier?
Yes, any tool that can send an HTTP request works. Send the POST request from Step 3; with "wait": true the response already contains the image URL.
