Images

Overview

Images adds a frontend generator to a WordPress page. Visitors enter a prompt, choose a provider and model if those controls are visible, and receive the generated media on the page. Use it for image generation, image editing, Google video generation, logged-in user history, usage limits, logs, and connected app recipes. In WordPress admin, go to AI Puffer > Images. Use the Image Generator tab to preview and publish the generator shortcode. Use the Settings tab for limits, UI text, custom CSS, and frontend model access.

Live image generator demo

Open the frontend image generator example.

Providers

See which providers support images, edits, and videos.

Generate Images

Let visitors create images from prompts.

Edit Images

Let visitors upload an image and describe changes.

Generate Videos

Use Google video models from the frontend generator.

Publish

Embed the generator with a shortcode or block.

Settings

Configure limits, UI text, custom CSS, and frontend model access.

Connected Apps

Send generated media events to external apps.

Logs

Review image, edit, and video activity.

Providers

Provider	Generate images	Edit images	Generate videos	Required setup
OpenAI	Yes	Yes	No	Add an OpenAI API key in Settings > AI, then sync models.
Google	Yes	Yes	Yes	Add a Google API key in Settings > AI, then sync image and video models.
OpenRouter	Yes	Yes, when the model supports image input and output	No	Add an OpenRouter API key in Settings > AI, then sync models.
Azure	Yes	No	No	Add the Azure API key and endpoint in Settings > AI, then sync deployments.
xAI	Yes	Yes	No	Add an xAI API key in Settings > AI, then sync image models.
Replicate	Yes	No	No	Add a Replicate API key in Settings > Integrations, then sync models.

Set up at least one image provider before publishing the generator. If the model list is empty, configure the provider in AI Providers, sync models, then return to Images.

xAI image generation and image editing use xAI image models such as grok-imagine-image. Generated xAI URLs are temporary, so AI Puffer stores generated images in the WordPress Media Library when possible.

Image editing only works with OpenAI, Google, OpenRouter, and xAI models that support image editing. xAI edit mode accepts JPG/JPEG and PNG source images.

Generate Images

To generate an image:

Open a page that contains the image generator.
Select the provider and model if those selectors are visible.
Enter the prompt.
Click Generate.

AI Puffer sends the prompt to the selected provider and displays the returned image in the results area. For logged-in users, generated images are saved to the WordPress Media Library.

Edit Images

Use edit mode when visitors should upload an image and describe the change they want. To enable edit mode from the Images screen:

Go to AI Puffer > Images > Image Generator.
Click the settings icon next to the shortcode.
Set UI Mode to Edit only or Generate + Edit.
If you choose Generate + Edit, choose the Default Mode and whether to show the mode switch.
Click the shortcode snippet to copy the updated shortcode.
Add it to a page.

To edit an image on the frontend:

Select Edit if the mode switch is visible.
Select OpenAI, Google, OpenRouter, or xAI.
Select a model that supports editing.
Upload one source image.
Enter the edit prompt.
Click Edit Image.

Upload rule	Value
Files	One source image
Types	JPG, PNG, WEBP, GIF
xAI types	JPG, PNG
Maximum size	10 MB

Generate Videos

Video generation uses Google video models. To use it:

Go to AI Puffer > Settings > AI.
Add the Google API key.
Sync Google models.
Return to AI Puffer > Images.
Publish the generator shortcode or block.
On the frontend, select Google and a video model.
Enter a prompt and click Generate.

Video generation is an . Keep the page open while AI Puffer checks the status. Completed videos are saved as MP4 files in WordPress uploads.

Publish

Shortcode

Add the basic shortcode to any page, post, or shortcode area:

[aipkit_image_generator]

Common examples:

[aipkit_image_generator mode="both" default_mode="generate"]
[aipkit_image_generator mode="edit"]
[aipkit_image_generator history="true"]
[aipkit_image_generator show_provider="false" show_model="false" provider="openai" model="gpt-image-2"]
[aipkit_image_generator show_provider="false" show_model="false" provider="xai" model="grok-imagine-image"]
[aipkit_image_generator theme="custom"]

Use the shortcode settings panel when you want to build the shortcode from the UI.

Go to AI Puffer > Images > Image Generator.
Click the settings icon beside the shortcode.
Choose the options you want.
Click the shortcode snippet to copy the updated shortcode.
Add it to a page or post.

Option	What it controls
Show Provider Select	Shows or hides the provider dropdown.
Show Model Select	Shows or hides the model dropdown.
UI Mode	Generate only, Edit only, or Generate + Edit.
Default Mode	The first selected mode when both Generate and Edit are enabled.
Show Mode Switch	Lets visitors switch between Generate and Edit.
Show User History	Shows previous generated media for logged-in users.
Theme	Light, Dark, or Custom CSS.

Attribute	Values	Default
`show_provider`	`true`, `false`	`true`
`show_model`	`true`, `false`	`true`
`provider`	`openai`, `google`, `openrouter`, `azure`, `xai`, `replicate`	`openai`
`model`	Provider model ID	`gpt-image-2`
`mode`	`generate`, `edit`, `both`	`generate`
`default_mode`	`generate`, `edit`	`generate`
`show_mode_switch`	`true`, `false`	`true` when `mode="both"`
`history`	`true`, `false`	`false`
`theme`	`dark`, `light`, `custom`	`dark`
`allowed_models`	Comma-separated model IDs	Uses global Images settings

When provider or model selectors are hidden, the shortcode uses the provider and model attributes as fixed values.

Block

Use the block when you prefer the block editor.

Edit a page or post.
Add the AI Puffer Image Generator block.
Choose whether to show provider and model selectors.
Choose the UI mode.
Enable history if needed.
Choose the theme.
Save the page.

Images block in the WordPress block editor

The block renders the same generator as the shortcode.

User History

History shows previously generated images and videos for logged-in users. To enable it, turn on Show User History in the shortcode settings panel, enable history in the block, or add history="true" to the shortcode.

Action	Availability
Open media	Images and videos
Delete media	Media owner or admin
Edit from history	Images only, when edit mode is enabled

Guest generations are not shown in user history.

Settings

Open AI Puffer > Images > Settings.

Limits

Limits control how much image generator usage is allowed for guests and logged-in users. Go to AI Puffer > Images > Settings, then use the Limits section.

Set Guest quota.
Choose Quota mode for logged-in users.
Set User quota or Role-based quotas.
Choose Reset period.
Edit Quota reached message.
Configure optional primary and secondary buttons.

Value	Meaning
Empty	Unlimited
`0`	Disabled
Positive number	Maximum allowed usage for the reset period

Reset periods are Never, Daily, Weekly, and Monthly.

For credit-based image access, define pricing rules in Usage. To sell prepaid credits, create WooCommerce credit packages in Usage.

UI Text

UI Text changes the frontend labels without editing code. Go to AI Puffer > Images > Settings, then use the UI Text section.

Field	Default
Generate button label	Generate
Edit button label	Edit Image
Mode tab label (Generate)	Generate
Mode tab label (Edit)	Edit
Generate prompt placeholder	Describe the image you want to generate…
Edit prompt placeholder	Describe how you want to edit the uploaded image…
Source image label	Source image
Upload dropzone title	Drop image here or click to upload
Upload dropzone meta	JPG, PNG, WEBP, GIF up to 10MB
Upload hint	Upload an image, then describe the edits in the prompt.
History title	Your Images
Results empty text	Generated images will appear here.

Custom CSS

Custom CSS applies to generators using the custom theme. Go to AI Puffer > Images > Settings, then use the Custom CSS section.

Use the custom theme in the shortcode:

[aipkit_image_generator theme="custom"]

Then target the custom wrapper:

.aipkit_image_generator_public_wrapper.aipkit-theme-custom {
  /* custom styles */
}

Provider Filtering

Provider filtering controls which models visitors can select when the frontend provider or model selectors are visible. Go to AI Puffer > Images > Settings, then use the Frontend Models section.

Select the models visitors can use.
Leave all models unselected if you want to allow every configured image and video model.
Save the settings.

AI Puffer builds the frontend provider list from the selected . For example, if you only select OpenAI models, the frontend provider selector only shows OpenAI. You can override the global setting for one page with the allowed_models shortcode attribute.

Connected Apps

Connected Apps can run a recipe after a successful image or video generation.

Go to AI Puffer > Settings > Apps.
Connect the app or webhook destination.
Create a recipe that uses the Image Generated event.
Publish the image generator on a page.
Generate an image or video to test the recipe.

AI Puffer emits image.generated after the output is complete. For payload fields, see Event Webhooks.

Logs

Image and video requests are logged with the module set to image_generator. Logs can include the prompt, provider, model, mode, usage, WordPress user, guest session, and edit source image metadata. Source image binary data is not stored in the log. Usage operations:

Operation	Used for
`generate`	Image generation
`edit`	Image editing
`video_generate`	Google video generation

Troubleshooting

The shortcode renders nothing

Check that Images is enabled in AI Puffer > Dashboard and that the shortcode is on a published page. Admin users may see a module-disabled message; visitors see empty output.

The provider or model list is empty

Configure the provider in AI Puffer > Settings > AI or Settings > Integrations, sync models, then reload the Images screen. If Provider Filtering is enabled, confirm that the selected models still exist.

Image editing does not work

Use OpenAI, Google, or OpenRouter. The selected model must support image editing, and the visitor must upload one JPG, PNG, WEBP, or GIF image under 10 MB.

Video generation keeps processing

Google video generation can take time. Keep the page open while AI Puffer checks the operation status. If it times out, try a shorter prompt and review the related log entry.

History is missing

History only appears for logged-in users. Enable Show User History in the shortcode settings panel, enable history in the block, or add history="true" to the shortcode.

Quota message appears

Open AI Puffer > Images > Settings > Limits and review the guest, user, or role-based quota. If you sell credits, also check the user’s balance and the pricing rules in Usage.

Overview

Getting Started

Setup

Modules

Utilities

Developers

Overview

Live image generator demo

Providers

Generate Images

Edit Images

Generate Videos

Publish

Settings

Connected Apps

Logs

Providers

Generate Images

Edit Images

Generate Videos

Publish

Shortcode

Block

User History

Settings

Limits

UI Text

Custom CSS

Provider Filtering

Connected Apps

Logs

Troubleshooting

Overview

Getting Started

Setup

Modules

Utilities

Developers

Documentation Index

​Overview

Live image generator demo

Providers

Generate Images

Edit Images

Generate Videos

Publish

Settings

Connected Apps

Logs

​Providers

​Generate Images

​Edit Images

​Generate Videos

​Publish

​Shortcode

​Block

​User History

​Settings

​Limits

​UI Text

​Custom CSS

​Provider Filtering

​Connected Apps

​Logs

​Troubleshooting

Overview

Providers

Generate Images

Edit Images

Generate Videos

Publish

Shortcode

Block

User History

Settings

Limits

UI Text

Custom CSS

Provider Filtering

Connected Apps

Logs

Troubleshooting