Here you'll find answers to the most common questions – and concrete fixes should an error message ever show up.

Common questions

Do I need my own OpenAI account?

Yes. The plugin uses your own OpenAI key. That way the cost is billed transparently through your account and you stay in control. You can create the key for free at platform.openai.com – see Setting up the OpenAI API key.

What does generating cost?

The plugin license is separate from the OpenAI cost. Per image you only pay a few cents in OpenAI fees – often fractions of that. With GPT-4o mini and low resolution it stays very cheap.

Which languages does the plugin work in?

German, English, French, Spanish, Italian and Dutch. The language is determined automatically from the shop context; the default language chosen in the configuration serves as the fallback.

Do existing alt texts get overwritten?

If you generate a new text for an image, it replaces an existing one. Generated texts live in the normal alt text field and are flagged as "AI-generated", so you can find them all in one place. You can edit or remove them by hand at any time.

Do I have to process images one by one?

No. You can select several images with the checkboxes, or work through a whole tab with Generate all – up to 100 images per run.

Which image formats are supported?

JPG, PNG, GIF and WebP. Other files (PDF, video or SVG, for instance) are skipped.

Troubleshooting

If an error occurs for an image, a short message appears in the progress list. Here are the most common ones – and what to do about them.

"API token is not configured"

No OpenAI key is stored. Enter it in the configuration under OpenAI API token. If you use channel-specific settings, make sure you're on the right sales channel.

"No AI model selected"

No model is selected. Pick a model in the configuration (default: GPT-4o mini) and save again.

"Invalid API token"

The key is wrong or expired. Check that you copied it completely and without extra spaces. When in doubt, create a new key at OpenAI and enter that.

"OpenAI Rate Limit reached"

You made a lot of requests in a short time and OpenAI is throttling you temporarily. Wait a moment and start again. Tip: process large batches in smaller chunks.

"The media is not an image"

The selected file is not an image. The plugin only processes image files (JPG, PNG, GIF, WebP).

"Image file could not be found"

The image file wasn't found. Check whether the file exists in the public folder. With offloaded storage (external CDN/cloud storage) the image must be reachable via its URL.

"Generated alt text is too short"

The generated text is shorter than your minimum length. In the configuration, lower the minimum number of characters or raise the maximum response length (tokens) so longer texts can be produced.

Stuck? We're happy to help. You can reach us directly via our contact page – after all, we know this plugin first-hand.