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

Other image API

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

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

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

Pricing is based on the selected size:

1. 1K - best for quick tests and lower cost
2. 2K - balanced quality and cost
3. 4K - highest quality tier

You can set your own prices for each tier through environment variables.

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:

{
    "operation": "generate",
    "taskId": "123"
}

Demo 2: Query the task result

{
    "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. NanoBanana: NanoBanana