🍌 Image Generation

Generate images from text prompts using Gemini Nano-Banana model

POST /vendors/google/v1/nano-banana/generation

Text to Image Generation

cURL

curl --request POST \
  --url https://api.mulerun.com/vendors/google/v1/nano-banana/generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A beautiful sunset over the mountains",
  "aspect_ratio": "16:9"
}
'

202

{
  "task_info": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "pending",
    "created_at": "2025-09-21T00:00:00.000Z",
    "updated_at": "2025-09-21T00:00:00.000Z"
  }
}

Generate images from text prompts using the Gemini Nano-Banana model.

Aspect Ratio

The aspect_ratio parameter allows you to specify the desired aspect ratio for the generated image. Different aspect ratios are suitable for different use cases.

Supported Aspect Ratios and Resolutions

Aspect Ratio	Resolution
1:1	1024×1024
2:3	832×1248
3:2	1248×832
3:4	864×1184
4:3	1184×864
4:5	896×1152
5:4	1152×896
9:16	768×1344
16:9	1344×768
21:9	1536×672

Note: The aspect_ratio parameter is optional. If not specified, the default aspect ratio will be used.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Text to image generation request body

prompt · string · required

Text prompt for image generation

aspect_ratio · enum<string> · default: 1:1

Aspect ratio of the generated image

Available options: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9

Response

202 - application/json

Task created successfully

task_info · object

Show child attributes