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
- 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).
- 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.
- 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).