API

Example request

Set your FLUX_API_KEY before running. See the parameters below for supported settings.

curl https://api.flux-context.org/api/v1/generations \
  -H "Authorization: Bearer $FLUX_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "nano-banana-2",
  "input": {
    "prompt": "Editorial portrait in natural light",
    "resolution": "2K",
    "aspect_ratio": "4:5"
  }
}'

Parameters

Set model to nano-banana-2. These fields belong inside input.

Reference media

Use your own publicly accessible HTTPS media URLs. Links must remain valid throughout queueing and generation. Base64 and file upload bodies are not supported by this endpoint.

curl https://api.flux-context.org/api/v1/generations \
  -H "Authorization: Bearer $FLUX_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "nano-banana-2",
  "input": {
    "prompt": "Editorial portrait in natural light",
    "resolution": "2K",
    "aspect_ratio": "4:5",
    "image_urls": [
      "https://example.com/front.jpg",
      "https://example.com/back.jpg"
    ]
  }
}'

Credits

Constraints

One output image per request. Web search is not enabled.

Use returned dimensions when available.

Response

A successful submission returns HTTP 202 and a request ID. Response excerpt:

{
  "id": "REQUEST_ID",
  "model": "nano-banana-2",
  "status": "processing"
}