Zum Hauptinhalt springen
POST
/
nano-banana
/
images
Nano Banana Images
curl --request POST \
  --url https://api.acedata.cloud/nano-banana/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "generate",
  "prompt": "a white siamese cat",
  "model": "nano-banana",
  "image_urls": [
    "<string>"
  ],
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "callback_url": "<string>"
}
'
{
  "success": true,
  "task_id": "93f11baf-347b-4bb4-9520-8653cb46d6a3",
  "trace_id": "a9063166-26ed-4451-85b5-54e896817c69",
  "data": [
    {
      "prompt": "let this man wear on this T-shirt",
      "image_url": "https://platform.cdn.acedata.cloud/nanobanana/8e9e0253-26f4-45b9-b3f8-ac1aed1c284b.png"
    }
  ]
}

Autorisierungen

​
Authorization
string
header
erforderlich

API token from https://platform.acedata.cloud

Header

​
accept
enum<string>

Specifies the format of the response from the server. If not specified, the default format is application/json.

Verfügbare Optionen:
application/json

Body

application/json
​
action
enum<string>
erforderlich

The action to generate the images. If generate, the images will be generated from the prompt. If edit, the images will be edited from the prompt and the image_urls.

Verfügbare Optionen:
generate,
edit
Beispiel:

"generate"

​
prompt
string
erforderlich

The prompt which used to generate the images.

Beispiel:

"a white siamese cat"

​
model
enum<string>

The model which used to generate the images. If not specified, the default model is nano-banana. nano-banana-2 is alias of gemini-3.1-flash-image (pro-level quality at flash speed), nano-banana-pro is alias of gemini-3-pro-image, nano-banana is alias of gemini-2.5-flash-image.

Verfügbare Optionen:
nano-banana,
nano-banana-2,
nano-banana-pro
​
image_urls
string[]

Link to the picture that needs to be edited. It can be a accessible http or https url or a base64 encoded image string like data:image/png;base64,iVBORw0KG... format. The image size should not exceed 10MB for each. If the action is edit, this parameter is required.

​
aspect_ratio
enum<string>

The aspect ratio of the generated images. Supported values are 1:1, 3:2, 2:3, 16:9, 9:16, 4:3, 3:4. Default is 1:1, this only works when action is generate. If action is edit, the aspect ratio will be determined by the first image in image_urls.

Verfügbare Optionen:
1:1,
3:2,
2:3,
16:9,
9:16,
4:3,
3:4
Beispiel:

"1:1"

​
resolution
enum<string>

The resolution of the generated images. Supported values are 1K, 2K, 4K. Default is 1K, this only works when action is generate. If action is edit, the resolution will be determined by the first image in image_urls. And this only works when model is nano-banana-pro.

Verfügbare Optionen:
1K,
2K,
4K
​
callback_url
string

The callback URL which will be called when the images is generated, the URL should be accessible from the public internet. If specified, the response will be returned immediately and the result will be sent to the callback URL when it's ready.

Antwort

OK, the request is successful.

The response is of type object.