Freepik NanoBanana Automation

Automate AI image generation on Freepik using Google's NanoBanana model. Run batch jobs, chain generation steps, and export results via API or no-code interface.

Overview

This actor automates the Freepik AI image generator. It handles authentication, manages concurrent jobs, and provides structured output. You can run multiple prompts, mix image inputs from various sources, and create workflows where outputs from one step feed into the next.

Key Features

• Batch Processing: Run multiple image generations in a single job with different prompts and settings.
• Step Chaining: Use the output images from one generation step as inputs for subsequent steps.
• Flexible Inputs: Accepts image URLs, uploaded files (upload:1, upload:2, etc.), Google Drive links, and references to previous outputs (output:step_name).
• Controlled Execution: Configure concurrency, random waits between tasks, and job timeouts to manage load.
• Album Export: Generates an album.html file for previewing and bulk downloading all created images.

How to Use

Prerequisites

1. A Freepik account with access to AI image generation.
2. Your freepik.com authentication cookie.
3. The Cookie-Editor browser extension to export the cookie.

To get your cookie:
1. Install Cookie-Editor.
2. Log into https://freepik.com.
3. Click the extension icon and grant permissions if prompted.
4. Click Export → Export as Header String.
5. Copy the entire string for the cookie input field.

Basic Setup

1. Paste your cookie string into the cookie input field.
2. Define your image generation steps in the generations array (see Input/Output section).
3. (Optional) Upload up to 10 images via the upload1…upload10 fields and reference them as upload:1, etc.
4. Adjust concurrency, minWait, maxWait, or jobTimeout if needed.
5. Run the actor. Upon completion, open the provided Album URL to view and download your images.

Input/Output

Key Input Parameters

The generations Field

Each object in the array represents a generation step. Available fields:

• prompt (string): The text instruction for image generation.
• images (array of strings): Input images. Can be URLs, upload:n references, output:name references, or Google Drive links.
• aspectRatio (string): Output aspect ratio (e.g., "1:1", "16:9"). Defaults to "1:1".
• runs (integer): Number of images to generate for this step. Defaults to 1.
• name (string): An identifier for this step. If set, its outputs can be referenced by later steps using output:name.

Notes:
* A step is skipped if it has neither a prompt nor images.
* Google Drive links are automatically converted.

Output

The primary output is an album.html file containing a gallery of all generated images with direct download links. Individual image files are also available in the dataset.