Vai al contenuto principale
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"
    }
  ]
}

Autorizzazioni

​
Authorization
string
header
obbligatorio

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

Intestazioni

​
accept
enum<string>

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

Opzioni disponibili:
application/json

Corpo

application/json
​
action
enum<string>
obbligatorio

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.

Opzioni disponibili:
generate,
edit
Esempio:

"generate"

​
prompt
string
obbligatorio

The prompt which used to generate the images.

Esempio:

"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.

Opzioni disponibili:
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.

Opzioni disponibili:
1:1,
3:2,
2:3,
16:9,
9:16,
4:3,
3:4
Esempio:

"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.

Opzioni disponibili:
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.

Risposta

OK, the request is successful.

The response is of type object.