KooKoo AI Alt Text Creator

AI Alt Text Creator is a complete solution for automating image SEO and accessibility on your WordPress site. It uses Artificial Intelligence to analyze your images and generate descriptive, context-aware Alt Text and Titles.

By connecting to OpenRouter, this plugin bypasses expensive monthly subscriptions, giving you direct access to the world’s best AI models (including Google Gemini, GPT-4, and Claude 3.5) at the lowest possible cost.

🚀 Key Features

One-Click Manual Generation: Instantly generate metadata for individual images directly from the Media Library list view. Perfect for new uploads or refining specific images.

Automated Background Processing: Process your entire back catalog automatically using the built-in Cron scheduler. Configure batch sizes and intervals to suit your server’s capacity.

Context-Aware Descriptions: The AI reads the Title and Content of the post/page the image is attached to. This ensures the generated Alt Text is relevant to your specific article, not just a generic description of the visual.

Global Context: Add custom instructions (e.g., “Always mention our brand name ‘Acme Corp'”) that apply to every image generated.

Smart Error Handling:

Retry Failed: Automatically logs failed attempts. You can retry all failed images with one click from the settings page.

JSON Fixer: A specialized tool to scan and fix images where the AI might have accidentally saved raw code instead of text.

Detailed Logging: View the exact generation timestamp, source (Manual vs Cron), and any error messages directly in the “Edit Media” screen.

Cost Control: You bring your own API key. You pay only for exactly what you use, with no markup.

Format Control: Choose exactly which file types to process (JPG, PNG, WEBP, etc.).

🧠 Why OpenRouter?

OpenRouter is an AI aggregator that offers significant benefits for WordPress users:

Cheaper: Models like Google Gemini 1.5 Flash are incredibly affordable (often fractions of a cent per image).

Flexible: Switch models instantly. If a new model is released tomorrow, you can simply paste its ID and use it immediately.

No Middleman: You use your own API key.

💡 Context & Prompts

You can customize exactly how the AI behaves using placeholders in your prompts:

Examples of Global Context:

Inputs:
– Page Topic: [{post_title}]
– Page Content: [{post_content}]
– Image: [attached image]

Examples of Alt Text Prompt:

Role: Web Accessibility and SEO Expert.
Task: Generate a single, optimized alt text string (MAX 125 characters) for the provided image, situated within the context of inputs.

Examples of Alt Text Prompt:

Role: SEO Copywriting Specialist.
Task: Generate 1 optimized image title based on the provided topic and attached image.

External Services

This plugin relies on OpenRouter as a third-party service to provide Artificial Intelligence capabilities.

Service Name: OpenRouter

Service URL: https://openrouter.ai/

Data Sent: Image URLs, Post Titles, and Post Content (context) are
sent to the OpenRouter API for processing.

Terms of Service: OpenRouter Terms https://openrouter.ai/terms

Privacy Policy: OpenRouter Privacy Policy
https://openrouter.ai/privacy

Note: You must obtain your own API key from OpenRouter to use this plugin.

Configuration

1. API Configuration

OpenRouter API Key: Sign up at OpenRouter.ai and paste your key here.

AI Model: Enter the model ID you wish to use (default: google/gemini-flash-1.5).

1. Generation Options

Global Context: Instructions sent with every request. Great for setting the “persona” of the AI.

Supported Image Formats: Define which file extensions the plugin should process.

Enable Alt Text / Title: Toggle which metadata fields you want to generate.

Prompts: Customize the specific instructions for generating Alt Text vs Titles.

Save Generation Info: Enables logging of timestamps and error messages to the database.

1. Bulk Generation (Cron)

Enable Background Processing: Turns on the automatic generator.

Batch Size: How many images to process per run. Keep this low (1-2) to prevent server timeouts.

Interval: How often the job runs (in minutes).