# Alt Text Generator (`balt1794/alt-ai-generator`) Actor Alt Text Generator automatically generates descriptive alt text for images using AI to help you rank faster on Google. Rank faster on search engines with SEO optimized alt text descriptions and increase visibility. - **URL**: https://apify.com/balt1794/alt-ai-generator.md - **Developed by:** [Bryam Loaiza](https://apify.com/balt1794) (community) - **Categories:** AI, SEO tools, Open source - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Alt Text Generator AI — Batch Image Descriptions Generate **SEO-friendly, accessibility-ready alt text** for hundreds of images in one run — powered by [Alt Text Generator AI](https://alttextgeneratorai.com). Perfect for content teams, WordPress sites, e-commerce catalogs, and WCAG accessibility audits. --- ### Get started in 2 minutes 1. **Get your API key** — sign up or log in at **[alttextgeneratorai.com](https://alttextgeneratorai.com)** and copy your API key. 2. **Paste image URLs** — add one or hundreds of direct image links (`.jpg`, `.png`, `.webp`, etc.). 3. **Run the Actor** — enter your API key, choose a language, click **Start**. 4. **Download results** — open the **Dataset** tab and export **JSON** or **CSV** with every `altText` ready to paste into your CMS. > Each generated alt text uses **one credit** on your [Alt Text Generator AI](https://alttextgeneratorai.com) account. This Actor is free on Apify — you pay Apify compute plus your API credits. --- ### What this Actor does | Feature | Description | | --- | --- | | **Bulk image URLs** | Paste many image links at once — no one-by-one uploads | | **35 languages** | English, Spanish, French, German, Italian, Portuguese, Dutch, Russian, Chinese, Japanese, Korean, Arabic, Swedish, Norwegian, Danish, Finnish, Polish, Turkish, Hindi, Bengali, Urdu, Thai, Vietnamese, Indonesian, Malay, Filipino, Greek, Hebrew, Hungarian, Czech, Romanian, Bulgarian, Ukrainian, Croatian, Serbian | | **Export-ready output** | Dataset with `imageUrl`, `altText`, `status`, and timing per row | --- ### Who it's for - **SEO teams** improving image search rankings and rich results - **Accessibility / WCAG** workflows fixing missing or weak `alt` attributes - **WordPress & CMS users** batch-processing media libraries - **Developers** automating alt text via the [Apify API](https://docs.apify.com/api/v2) --- ### Input guide | Field | What to enter | | --- | --- | | **Image URLs** | Public direct links to images (required) | | **Alt Text Generator AI API key** | Your key from [alttextgeneratorai.com](https://alttextgeneratorai.com) | | **Language** | Output language for all images in the run | | **Max images** | Cap per run (should not exceed your remaining credits) | #### Example image URLs ```` https://yoursite.com/uploads/2024/hero.jpg https://yoursite.com/uploads/2024/product-01.png ```` Use **direct image URLs**, not HTML page links. --- ### Output Each run produces a **dataset** with one row per image: | Column | Description | | --- | --- | | `imageUrl` | The image that was processed | | `altText` | Generated alt text (on success) | | `status` | `success` or `error` | | `charCount` | Length of generated alt text | | `processingTimeMs` | Time per image | A **SUMMARY** is also saved in the key-value store with run totals. --- ### Pricing | Where | Cost | | --- | --- | | **Apify** | Free Actor + standard Apify compute | | **Alt Text Generator AI** | [alttextgeneratorai.com](https://alttextgeneratorai.com) — **1 credit per image** | Get credits and manage your API key at **[https://alttextgeneratorai.com](https://alttextgeneratorai.com)** --- ### Tips for best results - Use **public, direct image URLs** (CDN or `/uploads/` links work best). - Avoid hotlink-blocked URLs; if an image fails, host it on your own domain. - Set **Max images** to match your remaining credits before large batch runs. --- ### Links - **Website & API keys:** [alttextgeneratorai.com](https://alttextgeneratorai.com) - **Apify platform docs:** [docs.apify.com](https://docs.apify.com) --- ### Support - API keys & credits → **[alttextgeneratorai.com](https://alttextgeneratorai.com)** - Actor issues → **Issues** tab on this Apify page # Actor input Schema ## `imageUrls` (type: `array`): Direct public URLs to images (jpg, png, webp, gif). One API credit per image. ## `wpkey` (type: `string`): Your API key from alttextgeneratorai.com. Each generated alt text uses one credit. ## `language` (type: `string`): Language for generated alt text. ## `maxImages` (type: `integer`): Hard cap per run. Must not exceed your remaining API credits. ## `maxConcurrency` (type: `integer`): Images processed in parallel. ## `apiUrl` (type: `string`): Override the Alt Text Generator AI API URL. Leave default unless testing. ## Actor input object example ```json { "imageUrls": [ "https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=400" ], "language": "en", "maxImages": 100, "maxConcurrency": 3, "apiUrl": "https://alttextgeneratorai.com/api/wp" } ```` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "imageUrls": [ "https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=400" ] }; // Run the Actor and wait for it to finish const run = await client.actor("balt1794/alt-ai-generator").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "imageUrls": ["https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=400"] } # Run the Actor and wait for it to finish run = client.actor("balt1794/alt-ai-generator").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "imageUrls": [ "https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=400" ] }' | apify call balt1794/alt-ai-generator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=balt1794/alt-ai-generator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Alt Text Generator", "description": "Alt Text Generator automatically generates descriptive alt text for images using AI to help you rank faster on Google.\n\nRank faster on search engines with SEO optimized alt text descriptions and increase visibility.", "version": "1.7", "x-build-id": "bZRdHD2GZTGvf8cyH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/balt1794~alt-ai-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-balt1794-alt-ai-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/balt1794~alt-ai-generator/runs": { "post": { "operationId": "runs-sync-balt1794-alt-ai-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/balt1794~alt-ai-generator/run-sync": { "post": { "operationId": "run-sync-balt1794-alt-ai-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "imageUrls", "wpkey" ], "properties": { "imageUrls": { "title": "Image URLs", "type": "array", "description": "Direct public URLs to images (jpg, png, webp, gif). One API credit per image.", "items": { "type": "string" } }, "wpkey": { "title": "Alt Text Generator AI API key", "type": "string", "description": "Your API key from alttextgeneratorai.com. Each generated alt text uses one credit." }, "language": { "title": "Output language", "enum": [ "en", "es", "fr", "de", "it", "pt", "nl", "ru", "zh", "ja", "ko", "ar", "sv", "no", "da", "fi", "pl", "tr", "hi", "bn", "ur", "th", "vi", "id", "ms", "fil", "el", "he", "hu", "cs", "ro", "bg", "uk", "hr", "sr" ], "type": "string", "description": "Language for generated alt text.", "default": "en" }, "maxImages": { "title": "Max images to process", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap per run. Must not exceed your remaining API credits.", "default": 100 }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Images processed in parallel.", "default": 3 }, "apiUrl": { "title": "API endpoint (advanced)", "type": "string", "description": "Override the Alt Text Generator AI API URL. Leave default unless testing.", "default": "https://alttextgeneratorai.com/api/wp" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```