AmazImg – AI Alt Text Generator for Accessibility & Image SEO

Ўсталёўка

1. You can install the plugin by uploading the .zip file in the plugins section of WordPress, or by adding the files to the folder /wp-content/plugins/amazimg-image-description-generator.
2. Go to Settings → Connectors, install a provider plugin (OpenAI, Anthropic or Google) and add its API key.
3. Optional: in Media → AI Alt Text → Settings, list the models you prefer, the output language and the maximum length.
4. Open any image in the Media Library and click Generate alt text.

Developers

AmazImg can be extended with PHP hooks and a small JavaScript API. The Pro add-on also adds a REST API and WP-CLI commands.

Filters

• aatg_generate_args ( $args, $attachment_id ): change the generation arguments.
• aatg_pre_generate ( null, $attachment_id, $args ): return a WP_Error to stop generation for an image.
• aatg_context ( $context, $attachment_id ): add context to the prompt, such as a post title or product name.
• aatg_language ( $language, $attachment_id ): choose the output language per image.
• aatg_prompt ( $prompt, $attachment_id, $context ): change the prompt sent to the AI.
• aatg_ai_prompt_builder ( $builder, $image, $prompt ): adjust the WordPress AI Client request before it is sent.
• aatg_max_tokens ( $max_tokens ): change the output limit (default 1024).
• aatg_image_sizes ( $sizes ): choose which image size is sent to the AI.
• aatg_parse_response ( null, $raw, $attachment_id ): parse a structured reply. Return an array with an alt key.
• aatg_is_decorative ( false, $attachment_id ): mark an image as decorative (empty alt text).
• aatg_query_args ( $query_args, $purpose, $args ): change which images are found.

Actions

• aatg_before_save ( $attachment_id, $result, $args ): runs just before alt text is saved.
• aatg_generated ( $attachment_id, $result, $context, $args ): runs after a successful generation.
• aatg_generate_failed ( $attachment_id, $error, $args ): runs after a failed generation.
• aatg_usage ( $provider, $model, $input_tokens, $output_tokens ): reports the AI usage of each request.

Error codes

• aatg_http_429: the AI provider is rate-limiting requests. Retry later.
• aatg_http_5xx (for example aatg_http_503): the AI provider is temporarily unavailable. Retry later.
• aatg_http_error: network error reaching the AI provider. Retry later.
• aatg_ai_error: any other AI request failure, for example an invalid API key. Don’t retry.
• aatg_no_key: no AI provider is connected in Settings → Connectors.
• aatg_unsupported: the file type is not supported. Use JPEG, PNG, GIF or WebP.

Examples

Add brand guidance to every prompt:

add_filter( 'aatg_prompt', function ( $prompt, $attachment_id, $context ) {
    return $prompt . "\nMention the brand name if a logo is visible.";
}, 10, 3 );

Skip images uploaded to a “logos” folder:

add_filter( 'aatg_pre_generate', function ( $error, $attachment_id ) {
    if ( false !== strpos( (string) get_attached_file( $attachment_id ), '/logos/' ) ) {
        return new WP_Error( 'my_skip', 'Logos are handled manually.' );
    }
    return $error;
}, 10, 2 );

Log every generated alt text:

add_action( 'aatg_generated', function ( $attachment_id, $result ) {
    error_log( sprintf( 'Alt text for #%d: %s', $attachment_id, $result['alt'] ) );
}, 10, 2 );

JavaScript

In the admin, AATG.generate( attachmentId, options ) returns a jQuery promise, and the aatg:generated event fires after each success:

AATG.generate( attachmentId, { source: 'my-plugin' } )
    .done( function ( data ) { console.log( data.alt ); } );

jQuery( document ).on( 'aatg:generated', function ( event, attachmentId, data ) {
    // data.pending is set when the result was held for review.
} );

REST API (Pro)

The Pro add-on adds routes under /wp-json/amazimg-pro/v1. To call them from outside WordPress, sign in with an application password (Users → Profile → Application Passwords) using HTTP Basic auth.

• GET /stats: total images, images missing alt text, items pending review, queue size, and this month’s usage and estimated cost. Needs the upload_files capability.
• GET /images?status=missing|low|all&page=1&per_page=20: lists images with their alt text, SEO score and issues, any pending suggestion, and whether undo is possible. Paging headers: X-WP-Total and X-WP-TotalPages. Needs upload_files.
• POST /images/{id}/generate: generates alt text for one image. Parameters: overwrite (default false), save (default true; false returns only a suggestion) and skip_review (default false). Needs permission to edit the image.
• POST /images/{id}/undo: restores the alt text from before the last AI change. Returns 409 when there is nothing to undo. Needs permission to edit the image.
• GET /queue: queue size and the last error. Needs upload_files.
• POST /queue: adds images to the background queue. Pass ids (an array of attachment IDs) or scope (missing, low or all), plus overwrite. Needs upload_files.

When the monthly spending cap is reached, generate returns HTTP 429 with the code aatgp_budget.

curl -u 'admin:xxxx xxxx xxxx xxxx' -X POST \
  'https://example.com/wp-json/amazimg-pro/v1/images/123/generate?save=false'

WP-CLI (Pro)

wp amazimg generate --limit=500
wp amazimg generate 12 34 --overwrite
wp amazimg generate --scope=low --products --skip-review
wp amazimg generate --queue
wp amazimg generate --dry-run
wp amazimg undo 12 34
wp amazimg undo --run=<run-id>
wp amazimg review list|approve|reject [<id>...]
wp amazimg sync-content [--replace] [--dry-run]
wp amazimg stats --format=json
wp amazimg queue status|run|clear

Rate limits and provider outages are retried automatically, up to 3 times, 30 seconds apart. Run wp help amazimg for the full reference.