Przejdź do głównej treści
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"
    }
  ]
}

Autoryzacje

​
Authorization
string
header
wymagane

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

Nagłówki

​
accept
enum<string>

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

Dostępne opcje:
application/json

Treść

application/json
​
action
enum<string>
wymagane

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.

Dostępne opcje:
generate,
edit
Przykład:

"generate"

​
prompt
string
wymagane

The prompt which used to generate the images.

Przykład:

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

Dostępne opcje:
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.

Dostępne opcje:
1:1,
3:2,
2:3,
16:9,
9:16,
4:3,
3:4
Przykład:

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

Dostępne opcje:
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.

Odpowiedź

OK, the request is successful.

The response is of type object.