NanoBanana Image API

Create high-quality AI images on Apify with a simple, low-cost workflow.

This Actor is designed for users who want:

1. Cheap, predictable pricing by image size
2. A fast and simple way to submit image generation tasks
3. Support for 1K, 2K, and 4K output tiers
4. A clean query flow to check task status and get the final image URL

Why use this Actor

1. Low cost for testing and production usage
2. Easy to use directly from Apify Console or API
3. Flexible input for both single-prompt and reference-image workflows
4. Built-in size selection for different quality and price needs

Other image API

1. Image 2 API
2. NanoBanana API
3. Midjourney API

Input

Generate task

Use operation=generate when you want to create an image task.

Required:

1. prompt

Optional:

1. imgUrls - reference images, up to 5
2. aspectRatio - auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
3. size - 1K, 2K, or 4K
4. notifyHook - webhook callback URL

Query task

Use operation=query when you want to check task status.

Required:

1. taskId

Pricing

Each successful generate operation charges one pay-per-event event:

1. 1K / Image-1K - $0.04 per generated task
2. 2K / Image-2K - $0.07 per generated task
3. 4K / Image-4K - $0.10 per generated task

Prices are configured in the Actor's Apify Monetization settings. The maximum total charge for a run must cover the selected event. If it does not, the Actor stops before calling the image generation API.

Query operations are free. Each query is a separate Actor run and writes one dataset item, so frequent polling still consumes platform resources. The Analytics result count includes generate, query, and error items; it is not the number of charged events.

Quick Demo

The default input already includes sample text and two sample reference images, so you can test it immediately.

Demo 1: Generate an image task

{
    "operation": "generate",
    "prompt": "The woman in picture 1 is wearing the clothes from picture 2",
    "imgUrls": [
        "https://sh2-1256181000.cos.accelerate.myqcloud.com/w_a/u_a/1/addImg/member-20251127/w1024_h1024_gNXNDQmtVWWhqR05YcFdZT3djVmU2Zz09-20ee04d2acc3a16268038b29df750874.jpeg",
        "https://sh2-1256181000.cos.accelerate.myqcloud.com/w_a/u_a/1/addImg/member-20250923/w1156_h1536_gNXNDQmtVWWhqR05YcFdZT3djVmU2Zz09-18debe4a45842af06885be6e3fb54d13.png"
    ],
    "aspectRatio": "auto",
    "size": "2K"
}

Example response:

{
    "success": true,
    "operation": "generate",
    "status": "SUBMITTED",
    "taskId": "123",
    "billing": {
        "size": "2K",
        "eventName": "Image-2K"
    }
}

Demo 2: Query the task result

{
    "success": true,
    "operation": "query",
    "taskId": "123"
}

Example response:

{
    "operation": "query",
    "taskId": "123",
    "status": "SUCCESS",
    "imgUrl": "https://example.com/image.png"
}

Output

Generate returns the submitted task information, including the task ID.

Query returns:

1. taskId
2. status
3. imgUrl

Best For

1. Product mockups
2. Fashion and clothing transformation demos
3. Fast image generation tests
4. Affordable tiered image workflows

Notes

1. This Actor submits generation tasks first, then you can query the result later.
2. If you need higher quality, choose a larger size tier.
3. The console input already includes sample prompt and reference images for easier testing.
4. A generated task is considered billable only when Apify confirms that exactly one matching event was charged.
5. NanoBanana: NanoBanana