FLUX.2

FLUX.2 is Black Forest Labs' resolution-controlled image family on Pixapi. Choose flux-2-pro, flux-2-max, or flux-2-flex, then pass resolution as 1MP, 2MP, 3MP, or 4MP.

API surface

Operation	Endpoint	Mode
Image generation	POST /v1/images/generations	Sync
Image generation task	POST /v1/async/images/generations	Async
Image editing	POST /v1/images/edits	Sync
Image editing task	POST /v1/async/images/edits	Async

Model ids

Model id	Best for
flux-2-pro	Balanced FLUX.2 quality and credit cost
flux-2-max	Highest-quality FLUX.2 output
flux-2-flex	Flexible FLUX.2 resolution tiers

Pricing

Model id	1MP	2MP	3MP	4MP
flux-2-pro	3	4	5	6
flux-2-max	6	8	10	13
flux-2-flex	4	8	12	16

If you omit resolution, Pixapi bills the 1MP tier.

Request fields

Field	Type	Required	Description
model	string	Yes	Use flux-2-pro, flux-2-max or flux-2-flex. Model ids are case-sensitive.
prompt	string	Yes	Prompt text, up to 2,000 characters.
image	string | string[]	For edits	Public image URL or an array of image URLs.
n	integer	No	Number of outputs. Default 1, maximum 9.
size	string	No	Provider-supported output size. Forwarded as-is for this family.
quality	string	No	Optional provider quality value.
output_format	string	No	Optional output format such as png, when supported upstream.
resolution	string	No	1MP (default), 2MP, 3MP, or 4MP. Controls output tier and billing.
providerOptions	object	No	Additional provider fields passed through by the gateway.

Example

cURL

curl https://api.pixapi.ai/v1/images/generations \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"flux-2-pro","prompt":"A clean editorial product photo on a warm gray background","n":1,"resolution":"2MP"}'

Python

import os
import requests

response = requests.post(
    "https://api.pixapi.ai/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
        "Content-Type": "application/json",
    },
    json={
  "model": "flux-2-pro",
  "prompt": "A clean editorial product photo on a warm gray background",
  "n": 1,
  "resolution": "2MP"
},
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://api.pixapi.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "model": "flux-2-pro",
  "prompt": "A clean editorial product photo on a warm gray background",
  "n": 1,
  "resolution": "2MP"
}),
});

if (!response.ok) {
  throw new Error(await response.text());
}

console.log(await response.json());

Go

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  body := []byte(`{
  "model": "flux-2-pro",
  "prompt": "A clean editorial product photo on a warm gray background",
  "n": 1,
  "resolution": "2MP"
}`)

  req, err := http.NewRequest(
    "POST",
    "https://api.pixapi.ai/v1/images/generations",
    bytes.NewBuffer(body),
  )
  if err != nil {
    panic(err)
  }
  req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
  req.Header.Set("Content-Type", "application/json")

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  result, _ := io.ReadAll(resp.Body)
  fmt.Println(string(result))
}

Edit an image

{
  "model": "flux-2-pro",
  "prompt": "Replace the background with a minimalist studio set",
  "image": "https://example.com/input.png",
  "n": 1
}

For async requests and task polling, see Async Media Tasks.

For the shared response shape, see the API Reference.