Media Metadata Generator

The Media Metadata Generator analyzes images in the media library and generates their metadata.

What it does

For an image, the expert generates:

Field	Description
title	The title of the media content — used as the image alt text
description	A short description of the media content — used as the image caption

The image itself is downloaded by the bundle and sent to the sulu.ai platform for visual analysis, so the metadata describes what is actually in the picture. Additional context (collection, tags, licensing, …) can be added via custom context providers.

Reviewing suggestions

If title and description are still empty, generation fills them directly. If they already hold content, a dialog opens and generation starts right away, showing the new suggestion next to the current content instead of overwriting it. Both columns are read-only comparisons; editors can toggle whether the suggestion should optimize the existing content, regenerate, or apply the suggestion with Insert. The optimize checkbox starts ticked, so the first suggestion is a rewrite of the current content rather than a fresh one; untick it and regenerate for a suggestion that ignores the existing text.

Metadata translation

Media metadata can also be translated into the other locales of the media, using the Translator — so alt texts and captions stay consistent across languages.

Image loading configuration

Because the bundle has to fetch the binary image data itself, the image_loader configuration matters here:

• allow_insecure_https — disable TLS certificate verification, useful for local *.wip domains with self-signed certificates
• authorization — send basic_auth or bearer_token credentials when your (staging) image host is protected

sulu_ai_platform:
    image_loader:
        authorization:
            type: 'basic_auth'
            value: '%env(STAGING_IMAGE_AUTH)%'   # Format: username:password

Permission

Gated by the sulu.ai.media_metadata_generator security context (category Sulu AI). Grant VIEW to roles that should see the generate action in the media library.

MCP

Available to AI clients as the sulu_ai_media_metadata_generate tool — see MCP Tools.