.. include:: /Includes.rst.txt

==============
Known Problems
==============

API Rate Limits
===============

The OpenAI API has rate limits that may affect bulk processing of large image collections.
If you encounter rate limit errors, try:

- Processing images in smaller batches
- Waiting a few minutes between bulk operations
- Upgrading your OpenAI API plan for higher limits

Image Size Limitations
======================

Very large images may take longer to process or fail due to API timeouts. The extension
automatically uses optimized image URLs, but extremely large files may still cause issues.

Multi-Site Environments
=======================

The extension automatically detects the current site based on the HTTP host. In complex
multi-site setups, ensure your site configurations have correct ``base`` and ``baseVariants``
settings.

Cache Issues
============

After changing extension configuration or site language settings, clear all TYPO3 caches
to ensure the changes take effect.

Reporting Issues
================

If you encounter any problems, please report them on the extension's issue tracker.

Support This Project
====================

Found a solution to a problem? Consider giving back:

.. tip::

   `Donate via PayPal <https://www.paypal.com/paypalme/99grad/10>`__ ❤️

Your support helps us fix bugs and improve the extension.