Nano Banana - Generate Image (AI Model · By )

API Documentation

API Reference

Images

Generate Image

Supported Model Code

Loading models...

Nano Banana (NB)

NB0 models support this endpoint

Specializes in natural language-based image generation and editing, capable of creating hyper-realistic, physically consistent visual effects and achieving seamless style transfer.

Generate image

https://api.modelstream.ai

POST/v1/images/generations

Authentication

BearerAuth

AuthenticationBearer <token>

All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx

Parameter Location: Header Param

Request Body

application/json

These parameters come from the selected model form_schema. Switching models updates this list and the request example.

prompt*string

Text instruction for editing/blending. Nano Banana (Gemini 2.5 Flash Image) edits, restyles, or merges the uploaded reference images according to the prompt.

RequiredExample Value: A cute cat sleeping in the sunshine, soft lighting, highly detailed fur, cinematic atmosphere.Placeholder: Describe how to edit or blend the reference images, e.g. place the cat on a sunny windowsill...

images*array

Upload the image(s) to edit or blend, up to 3. The model performs image-to-image editing on them according to the prompt.

RequiredValue Range: 0 ≤ value ≤ 3

size?string

Aspect ratio of the output image. Default 1:1.

Example Value: 1:1

Enum/Options:

1:12:33:23:44:34:55:49:1616:921:9

Response Parameters

application/json

200apiDocs.responses.successGenerateImage

created?integer

Parameter description for Created

data?array

Parameter description for Data

curl -X POST "https://api.modelstream.ai/v1/images/generations" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "NB",
  "prompt": "A cute cat sleeping in the sunshine, soft lighting, highly detailed fur, cinematic atmosphere.",
  "n": 1,
  "size": "1:1",
  "quality": "1K",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "A cute cat sleeping in the sunshine, soft lighting, highly detailed fur, cinematic atmosphere."
        }
      ]
    }
  ]
}'

{
  "created": 0,
  "data": [
    {
      "url": "string",
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ]
}

API Documentation

API Reference

Images

Generate Image

Supported Model Code

Loading models...

Nano Banana (NB)

NB0 models support this endpoint

Specializes in natural language-based image generation and editing, capable of creating hyper-realistic, physically consistent visual effects and achieving seamless style transfer.

Generate image

https://api.modelstream.ai

POST/v1/images/generations

Authentication

BearerAuth

AuthenticationBearer <token>

All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx

Parameter Location: Header Param

Request Body

application/json

These parameters come from the selected model form_schema. Switching models updates this list and the request example.

prompt*string

Text instruction for editing/blending. Nano Banana (Gemini 2.5 Flash Image) edits, restyles, or merges the uploaded reference images according to the prompt.

images*array

Upload the image(s) to edit or blend, up to 3. The model performs image-to-image editing on them according to the prompt.

RequiredValue Range: 0 ≤ value ≤ 3

size?string

Aspect ratio of the output image. Default 1:1.

Example Value: 1:1

Enum/Options:

1:12:33:23:44:34:55:49:1616:921:9

Response Parameters

application/json

200apiDocs.responses.successGenerateImage

created?integer

Parameter description for Created

data?array

Parameter description for Data

curl -X POST "https://api.modelstream.ai/v1/images/generations" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "NB",
  "prompt": "A cute cat sleeping in the sunshine, soft lighting, highly detailed fur, cinematic atmosphere.",
  "n": 1,
  "size": "1:1",
  "quality": "1K",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "A cute cat sleeping in the sunshine, soft lighting, highly detailed fur, cinematic atmosphere."
        }
      ]
    }
  ]
}'

{
  "created": 0,
  "data": [
    {
      "url": "string",
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ]
}

Nano Banana - Generate Image (AI Model · By ) | ModelStream