Image generation

Generating images with Aimogen Pro across seven providers, writing effective image prompts, sizing, and where generated images are used.

Settings › AI Images holds the global defaults; most features can override them per rule, per block or per shortcode.

Provider credentials and provider-specific parameters are in Image and video providers.

Global defaults#

SettingWhat it controls
AI Image ModelDefault model, gpt-image-2 in 2.8.8
AI Generated Image SizeDefault dimensions
Copy Royalty Free / AI Images From Post ContentWhere images are stored
AI Generated Image Resize Width / HeightResize on import
Resize QualityJPEG quality for the resize
Disable Compression / Compression QualityRecompression on import
Delay Between API Requests For AI Image Generator APIs (ms)Throttle, on Settings › API Keys
Do Not Translate Image QueriesKeeps non-English prompts in their original language

Writing image prompts#

Image prompts are not article prompts. They describe a picture.

Weak: An image about coffee machines

Better:

A minimalist product photograph of a stainless steel espresso machine on a
light oak kitchen counter. Soft morning light from the left, shallow depth of
field, warm neutral palette. No text, no people, no logos.

What makes the difference:

ElementWhy
Subject, stated concretelyThe model needs something to draw
SettingPrevents a floating object on a blank background
LightingThe largest single influence on how the image feels
CompositionDepth of field, angle, framing
PaletteKeeps a bulk run visually coherent
Exclusions"No text, no people, no logos" prevents the most common unwanted elements

Placeholders in image prompts#

Image prompts accept the same placeholders as text prompts, including %%post_title%%, %%post_content%%, %%post_content_plain_text%%, %%post_excerpt%%, %%post_cats%%, %%post_tags%%, %%blog_title%%, %%author_name%%, %%current_date_time%% and %%related_questions_KEYWORD%%.

A prompt that adapts to the article while keeping a house style:

A photorealistic editorial image illustrating: %%post_title%%

Style: natural light, muted colours, shallow depth of field, no text, no people.

Prompt lists#

Where a prompt field accepts multiple lines, one is chosen per run. This is how you get visual variety across a bulk run.

The field can also hold a URL to a .txt file of prompts, one per line, which lets you maintain a large prompt bank outside WordPress and change it without editing rules.

Sizes#

Available sizes depend on the provider and model. Considerations:

  • Larger costs more with every provider.
  • Aspect ratio matters more than resolution for a featured image — a square image in a wide hero slot gets cropped badly.
  • Resize on import. A 1024×1024 PNG is often several megabytes; the resize settings fix that.

Where images are used#

UseConfigured in
Featured imageThe rule, Article Featured Image Source
In-article imagesThe rule, Number of Images To Add To The Article
One per headingThe rule, Add An Image To Each Heading Of The Article
By the AI Content EditorAn editor template
In a workflowAn image OmniBlock
By the chatbotAn image extension
By visitorsThe image generator shortcodes
ManuallyThe Media Library or the Playground

Display shortcodes#

Two families exist and they do different things:

Generate and display inline[aimogen-image], [aimogen-stable-image], [aimogen-google-image], [aimogen-midjourney-image], [aimogen-replicate-image], [aimogen-ideogram-image], [aimogen-cloudflare-image]. These generate an image when the content renders, and cache the result.

A form for visitors — the -generator-form variants. These render a form the visitor uses.

See Shortcode reference.

Image SEO#

Generated images can have alt text, captions, descriptions and titles written automatically. See Media Library tools.

Royalty-free sources often require attribution; %%royalty_free_image_attribution%% produces the correct credit text.

Common problems#

Images generate but do not appear. Copying is disabled and the provider URL expired. Turn on Copy Royalty Free / AI Images From Post Content.

429 during bulk runs. Image endpoints rate-limit harder than text. Raise the image request delay.

The prompt was rejected. Every provider applies content policy. Rephrase.

Every image looks the same. One prompt line. Add more, or raise variety in the prompt.

Images are enormous. Set the resize width and compression quality.

Text in images is garbled. Expected from most models. Use Ideogram, or exclude text.

Still stuck? Open a support ticket and include the diagnostics from Aimogen Pro › System & Logs › System Info.