APIMart
Back to models
FLUX 3 Image model icon
ImageImage GenerationUp to 10 ReferencesSearch GroundingResolution-Based Pricing

FLUX 3 Image API

FLUX 3 Image by Black Forest Labs is the image model of the FLUX 3 API. It generates one image per request from text or up to 10 references, at five resolution tiers up to 4K. Resolution sets the price; reference images add no separate charge.

Generated image 1

Pricing Details

Transparent pricing with no hidden fees. Pay only for what you use.

Pricing by specification

* Actual costs are subject to final output.

FLUX 3 API for Image Generation and Editing

Use the FLUX 3 API to create images from text, edit a reference or combine up to 10 images. Choose a resolution and aspect ratio, control search grounding, and describe layouts in your prompt. Klein and Video use the same APIMart key.

FLUX 3 Image Klein is the smaller, faster open-weights model in the same family. It adds seed, 1–16 steps and PNG or JPEG output at a lower price per image. View FLUX 3 Image Klein

FLUX 3 Image Capabilities

Generation, editing and output controls supported by the API

Text-to-Image Generation

Describe the subject, composition, lighting and style to create a new image.

Reference-Image Editing

Edit one image or combine up to 10 references with instructions in the prompt.

Five Output Resolutions

Choose 768sq, 1k, 1.5k, 2k or 4k. The default is 1k; higher resolutions affect the price.

Flexible Aspect Ratios

Choose from 15 ratios or auto. When editing, auto follows the first reference image.

Layout Instructions

Describe bounding-box layout and local edits in the prompt using the documented syntax. This is not a visual box-drawing editor.

Search Grounding

Allow the upstream model to retrieve web or image context before generation. Grounding is on by default and can be disabled.

Safety Tolerance

Set safety_tolerance from 0 to 4, with 0 being strictest. The default is 2.

Per-Image Pricing

Each request generates one image. Price depends on resolution, not aspect ratio or the number of references.

FLUX 3 Image Use Cases

Suggested uses for creative, commerce, and content teams

  • Product Visual Concepts

    Explore product-scene drafts and local adjustments, with checks for product details and faithful presentation before use.

  • Campaign Drafts

    Develop campaign directions and plan element placement, then review the selected image against the creative brief.

  • Storyboards and Presentations

    Create still-image drafts to communicate a scene or presentation concept; review each image before assembling a sequence.

  • Creative Revisions

    Try targeted changes to a design and compare them with earlier drafts, keeping human approval in the workflow.

  • Editorial Illustrations

    Develop illustration concepts for articles and guides, with editorial review to keep imagery aligned with the story.

  • Packaging and Poster Concepts

    Explore composition ideas for packaging or posters, reserving space for copy and checking final brand and print requirements separately.

How to Get a FLUX 3 Image API Key and Start Building

Three steps from sign-up to your first FLUX 3 Image API request

  1. 1

    Create an APIMart Account

    Sign up for free. One account gives you the FLUX 3 Image API and every other model on APIMart.

  2. 2

    Add Credits

    Top up your balance. FLUX 3 Image is billed per image by resolution tier, and the same balance works across all models.

  3. 3

    Get Your API Key

    Create an API key in the dashboard and send it as a Bearer token to POST /v1/images/generations with model flux-3-image.

FLUX 3 Image API Example: Text to Image and Image Editing

Call flux-3-image with one POST request. Generation is asynchronous: submit a task, then poll the task endpoint for the image URL.

  1. 1

    Authenticate FLUX 3 API requests

    Save your APIMart key in the APIMART_API_KEY environment variable and send it as Authorization: Bearer <key> on every request.

  2. 2

    Submit a FLUX 3 Image task

    POST /v1/images/generations with model flux-3-image, your prompt, resolution and aspect_ratio. Add image_urls to edit or combine references. The example.com URLs are placeholders: replace them with your own publicly accessible images or Base64 data. The task ID is in data[0].task_id.

  3. 3

    Get the FLUX 3 Image result

    Poll GET /v1/tasks/{task_id} until status is completed, then read the image URL from data.result.images[0].url[0]. APIMart keeps results for 72 hours, so download the images you want to keep.

    See the FLUX 3 Image API reference for every parameter, layout syntax and response field.

POST /v1/images/generations
curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image",
    "prompt": "A ceramic coffee cup on a linen tablecloth by a window, soft morning light, product photo, the word MORNING printed on the cup",
    "resolution": "1k",
    "aspect_ratio": "16:9"
  }'

FLUX 3 Image API Parameters

ParameterTypeRequiredDefaultDescription
modelstringRequiredDefault: flux-3-imageUse flux-3-image.
promptstringRequiredDefault: —Scene description for text-to-image, or edit instructions. Negative prompts are not supported; describe what you want to see.
image_urlsstring[]OptionalDefault: —Up to 10 reference images as public HTTP(S) URLs or Base64. Omit for text-to-image; the first image is the one being edited.
resolutionstringOptionalDefault: 1k768sq, 1k, 1.5k, 2k or 4k (about 16 MP). Sets the price per image.
aspect_ratiostringOptionalDefault: autoOne of 15 ratios from 21:9 to 9:21, or auto. Pixel sizes such as 1024x1024 return HTTP 400.
groundingbooleanOptionalDefault: trueAllow web or image search before generation. Send the boolean false to disable it.
safety_toleranceintegerOptionalDefault: 20 (strictest) to 4.

Compare FLUX API Models on APIMart

One APIMart API key calls every FLUX model below. Image models are billed per image and FLUX 3 Video per second of video.

ModelBest forOutput
FLUX 3 Image APIThis pageThe FLUX 3 API for images: generation and editing with up to 10 references, search grounding and output up to 4K768sq to 4K (about 16 MP)
FLUX 3 Image Klein APILower-cost FLUX 3 images with seed, 1–16 steps and PNG or JPEG output768sq to 4K (about 16 MP)
FLUX 3 Video APIText to video, 1–10 keyframes, video continuation and drafts, with synced audioHD or FHD, 5–20 s
FLUX.2 APIChoosing between FLUX.2 Pro, Max and Flex on one page1–4 MP
FLUX.2 Pro APIBalanced quality and cost for production images, up to 8 references1–4 MP
FLUX.2 Max APIThe highest-quality FLUX.2 output, up to 8 references1–4 MP
FLUX.2 Flex APIAdjustable steps and guidance for typography and layout-heavy designs1–4 MP
FLUX.1 Kontext APIChoosing between FLUX.1 Kontext Pro and Max on one pageAbout 1 MP
FLUX.1 Kontext Pro APIContext-aware edits at a fixed price per image, up to 4 referencesAbout 1 MP
FLUX.1 Kontext Max APIHigher-quality Kontext edits with stronger prompt adherenceAbout 1 MP

FLUX 3 Image FAQ

Inputs, output settings, billing and task handling

What is the FLUX 3 API?

FLUX 3 is Black Forest Labs' multimodal model family. On APIMart the FLUX 3 API covers three models with one key: FLUX 3 Image (flux-3-image, this page) for image generation and editing, FLUX 3 Image Klein (flux-3-image-klein) for lower-cost images, and FLUX 3 Video (flux-3-video) for video with audio. Each FLUX 3 Image request returns one final image.

When was FLUX 3 Image released?

Black Forest Labs announced FLUX 3 on July 23, 2026 and released FLUX 3 Image through its API on October 1, 2026, according to its release notes. On APIMart you call it with model flux-3-image.

How many reference images can I use?

image_urls accepts up to 10 publicly accessible HTTP(S) URLs or base64 images. Adding references makes the request an editing or multi-reference task. References do not add a separate charge.

Which resolutions and aspect ratios are supported?

Resolutions are 768sq, 1k, 1.5k, 2k and 4k. Choose auto or one of 15 ratios from 21:9 to 9:21. Defaults are 1k and auto. Auto follows the first reference when editing; text-only generation follows the prompt or defaults to 1:1.

What do grounding and safety_tolerance control?

grounding defaults to true and allows upstream web or image retrieval before generation; set it to false to disable retrieval. safety_tolerance is an integer from 0 to 4, where 0 is strictest and the default is 2.

How do bounding-box instructions work?

Layout and local-edit instructions belong in prompt, using the syntax described in the official documentation. The tool does not provide a visual bounding-box editor or a separate bbox parameter.

How much does the FLUX 3 Image API cost?

The price per image depends only on resolution. Original prices on APIMart (October 2026): 768sq $0.041, 1k $0.048, 1.5k $0.07, 2k $0.10 and 4k $0.607. Aspect ratio and reference count do not change the price. Gold members pay 20% less and Platinum and Diamond members save up to 28%; the pricing table on this page shows current rates, and the completed task's cost is the final charge. Failed or moderation-blocked tasks are fully refunded.

How do I receive the generated image?

POST /v1/images/generations returns a task_id. Query GET /v1/tasks/{task_id} until the task completes or fails, then read the image URL from data.result.images[0].url[0]. A 4k task may take several minutes. APIMart keeps results for 72 hours, so download the images you want to keep.

Can I reuse parameters from other FLUX models?

Not without checking. This API does not accept width, height, pixel-size strings, seed, steps, guidance, output_format, negative_prompt or prompt_upsampling, and it does not generate multiple images per request. Choose resolution and aspect_ratio instead.

How do I get a FLUX 3 API key?

Sign up for APIMart, add credits, then create a key on the API Keys page of the dashboard. Send it as a Bearer token with each request. The same key calls FLUX 3 Image, FLUX 3 Image Klein, FLUX 3 Video and every other model on APIMart, with pay-as-you-go billing.

Guides, comparisons and pricing analysis from the APIMart blog.