Nano Banana Pro Image to Image API

Create Task

POST https://aigptimage.com/api/v1/jobs/createTask
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Input Parameters

Field	Type	Required	Description
`prompt`	`string`	Yes	Transformation instruction. Max 20000 characters
`image_input`	`string[]`	Yes	Public HTTPS input image URLs. Up to 8 images
`aspect_ratio`	`string`	No	Options: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`, `auto`. Default: `1:1`
`resolution`	`string`	No	`1K`, `2K`, or `4K`. Default: `1K`
`output_format`	`string`	No	`png` or `jpg`. Default: `png`

Source Image Requirements

Use public https:// image URLs.
Supported formats: JPEG/JPG, PNG, WEBP.
Max size: 30MB per image.
Do not send local file paths, binary uploads, raw base64 strings, or inline data:image/...;base64,... URLs.

Request Example

{
  "model": "nano-banana-pro-image-to-image",
  "input": {
    "prompt": "Turn this product image into a cinematic magazine advertisement",
    "image_input": ["https://cdn.example.com/input.png"],
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }
}

Create Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_xxxxxxxxxxxxx"
  }
}

Save data.taskId; you need it to query the result.

Query Task

GET https://aigptimage.com/api/v1/jobs/recordInfo?taskId=task_xxxxxxxxxxxxx
Authorization: Bearer YOUR_API_KEY

When data.state is success, parse data.resultJson as JSON and read resultUrls.

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_xxxxxxxxxxxxx",
    "model": "nano-banana-pro-image-to-image",
    "state": "success",
    "param": "{\"model\":\"nano-banana-pro-image-to-image\",\"input\":{\"prompt\":\"Turn this product image into a cinematic magazine advertisement\",\"image_input\":[\"https://cdn.example.com/input.png\"],\"aspect_ratio\":\"1:1\",\"resolution\":\"1K\",\"output_format\":\"png\"}}",
    "resultJson": "{\"resultUrls\":[\"https://cdn.example.com/result.png\"]}",
    "failCode": null,
    "failMsg": null,
    "costTime": 12000,
    "completeTime": 1757584176490,
    "createTime": 1757584164490
  }
}

Error Codes

Status Code	Description
`400`	Invalid request parameters
`401`	Authentication failed or API key is invalid
`402`	Insufficient credits
`404`	Task not found
`409`	Active task limit exceeded or request conflict
`422`	Parameter validation failed
`429`	Request rate limit exceeded
`500`	Internal server error

Nano Banana Pro Image to Image API

Create Task

Input Parameters

Source Image Requirements

Request Example

Create Response

Query Task

Error Codes

On this page