---
title: "Introduction"
manual: "Ai3 Alt Text"
version: "0.9"
permalink: "https://docs.typo3.org/permalink/wegewerk/ai3_alttext:introduction@0.9"
source: "Introduction/Index.rst"
rendered: "2026-10-23T16:31:04+00:00"
---

# Introduction {#introduction}

## What does it do? {#what-it-does}

**Ai3 Alt Text** (extension_key) is a TYPO3 extension that automates
the creation of accessible alternative texts for images stored in the
TYPO3 file storage. It communicates with the **ZAK-AI REST API** —
provided by [`wegewerk/ai3_core`](https://packagist.org/packages/wegewerk/ai3_core) — to generate descriptive,
language-aware alt texts using a vision-capable AI model.

The extension adds a dedicated backend module under
**File > AI3 metadata** with two views:

-   **File metadata view**

    Lists all images in a selected folder. For each image the current
    alt text, AI-generated suggestion, usage count, and available
    actions are shown. Editors can generate alt texts individually or
    in bulk, review suggestions, and approve or edit them before they
    are saved to the file metadata record.

-   **Folder view**

    Shows the sub-folder tree of the file storage. Editors can accept
    all pending AI suggestions across an entire folder hierarchy with a
    single click.

In addition, a **FormEngine field control** button is injected into the
**Alternative Text** field of the file metadata edit form,
allowing editors to queue a single image for alt text generation without
leaving the record editor.

## Screenshots {#screenshots}

> [!NOTE]
> Screenshots will be added in a future release.

## Requirements {#requirements}

-   TYPO3 CMS min_typo3, 13.4, or 14.0
-   [`wegewerk/ai3_core`](https://packagist.org/packages/wegewerk/ai3_core) (installed automatically as a
    Composer dependency)
-   A valid ZAK-AI account with `ZAKAI_API_KEY` and `ZAKAI_SECRET`
    environment variables set on the server