Image generation API focused on nano-banana-2

Payload fields

• prompt (required): description to generate.
• model (required): recommended value is nano-banana-2.
• mode (optional): text-to-image (default) or image-to-image; image mode needs at least one reference image.
• aspectRatio (optional): default auto; accepts 1:1, 16:9, 9:16, etc.
• imageSize (optional): default 1K; accepts 1K/2K/4K.
• outputFormat (optional): default png.
• isPublic (optional): default true.
• imageFile (optional, FormData): upload reference files for image-to-image; up to 8 files, each <=10 MB.
• imageUrl (optional): reference image URL(s); accepts string or string[], counts toward the 8-image cap.
• imageData (optional, legacy): base64 data URL is accepted for compatibility, but multipart file upload is recommended.

Sample request

curl -X POST https://nanobananapro.cloud/api/v1/image/nano-banana \
  -H "Authorization: Bearer api-key" \
  -F "prompt=A banana cat in a spacesuit on the moon" \
  -F "model=nano-banana-2" \
  -F "mode=image-to-image" \
  -F "aspectRatio=auto" \
  -F "imageSize=1K" \
  -F "outputFormat=png" \
  -F "isPublic=true" \
  -F "imageFile=@/path/to/ref.png" \
  -F "imageUrl=https://example.com/ref2.png"

Sample response

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task-id-xxx",
    "results": [],
    "progress": 0,
    "status": "running",
    "failure_reason": null,
    "error": null,
    "credits_cost": 20
  }
}

Sample request

curl -X POST https://nanobananapro.cloud/api/v1/image/nano-banana/result \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer api-key" \
  -d '{
    "taskId": "task-id-xxx"
  }'

Sample response

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task-id-xxx",
    "results": [
      {
        "url": "https://example.com/generated.png",
        "content": "A banana cat in a spacesuit on the moon"
      }
    ],
    "progress": 100,
    "status": "succeeded",
    "failure_reason": null,
    "error": null
  }
}