Black Forest Labsimage1 route

Flux 3 API

Black Forest Labs's Flux 3: text to image and image editing, up to 4K.

flux-3Connect to ClaudeGet API key

Pricing per image

SizePer image
768SQ$0.05lowest5 credits
1K$0.05lowest5 credits
1.5K$0.077 credits
2K$0.1010 credits
4K$0.6161 credits

Billed in credits per image (100 credits = $1, rounded up to a whole credit). Charged once, only for the route that succeeds. Failed attempts cost $0.00.

Request

# One Idempotency-Key per request, made once and sent again with every resend of it
KEY=$(uuidgen)

# 1. Submit. max_cost_usd is your cap: the most this may cost (it lists at $0.05).
#    No id after a timeout, a 429 or a 5xx? Run step 1 again: the same $KEY never makes a second one.
RESP=$(curl -s https://api.revana.si/v1/generations \
  -H "Authorization: Bearer $REVANA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $KEY" \
  -d '{
    "model": "flux-3",
    "input": {
      "prompt": "A product photo of a ceramic coffee cup on a linen tablecloth, soft morning light",
      "resolution": "1K"
    },
    "max_cost_usd": 0.08
  }')
ID=$(echo "$RESP" | jq -r '.id // empty')
echo "${ID:-no id: ${RESP:-no answer}}"

# 2. Poll it until status is "succeeded" or "failed". A failed one is free; to try it again,
#    make a new key first (KEY=$(uuidgen)): the old one answers with the failure.
curl -s https://api.revana.si/v1/generations/${ID:?no id from step 1} \
  -H "Authorization: Bearer $REVANA_API_KEY"

# 3. Download the file once it has succeeded
curl -L https://api.revana.si/v1/generations/${ID:?no id from step 1}/content \
  -H "Authorization: Bearer $REVANA_API_KEY" \
  -o out.png

Set REVANA_API_KEY to your key. Full reference in the quickstart.

Options

Tasks
Text to imageImage to image
Resolutions
768SQ1K1.5K2K4K
Input images
Up to 10
Billing unit
per image
Model id
flux-3

1 route

One route today. If it fails you are not charged.

About the Flux 3 API

How much does the Flux 3 API cost?

Flux 3 costs from $0.05 per image on Revana (768SQ: $0.05; 1K: $0.05; 1.5K: $0.07; 2K: $0.10; 4K: $0.61). You pay in prepaid credits, 100 credits to the dollar, with no subscription or monthly minimum. A generation that fails costs nothing.

How do I call Flux 3 from code?

Send POST https://api.revana.si/v1/generations with {"model": "flux-3", "input": {...}} and your Revana API key as a Bearer token, poll GET /v1/generations/{id} until it succeeds, then download GET /v1/generations/{id}/content. Every model on Revana takes the same request shape.

What happens if a Flux 3 generation fails?

You are charged once, only for the route that delivers. A failed generation costs $0.00.

What can Flux 3 do on Revana?

Flux 3 supports text to image and image to image, resolutions 768SQ, 1K, 1.5K, 2K, 4K and up to 10 input images. A value it does not offer is refused with 422 before anything is charged.

Can my AI agent use Flux 3?

Yes. Connect the Revana MCP server (https://revana.si/api/mcp) to Claude, ChatGPT, Cursor or Codex, or have the agent call the REST API. The agent can list models, get a free quote and generate on your credits.

Guides

Compare with similar models

Also as markdown for agents. Every model and price: models.json.