---
canonical_url: "https://docs.composio.dev/toolkits/alt_text_lab"
markdown_url: "https://docs.composio.dev/toolkits/alt_text_lab.md"
product: "platform"
version: null
last_updated: null
---

# AltTextLab

Generate accessible, SEO-aware image alt text and inspect account credit availability with AltTextLab.

- **Category:** ai content generation
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 2
- **Triggers:** 0
- **Slug:** `ALT_TEXT_LAB`
- **Version:** 20260910_00

## Tools

### Generate Alt Text

**Slug:** `ALT_TEXT_LAB_GENERATE_ALT_TEXT`

Generate accessible alt text for a publicly reachable image URL, optionally guided by language, writing style, SEO keywords, product details, and page context. Each generated result consumes one account credit. Do not retry after a timeout or ambiguous provider failure; check account credits first.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `style` | string ("descriptive" | "neutral" | "matter-of-fact" | "minimal") | No | Writing style for the alt text; omit to use the account setting. |
| `context` | object | No | Optional page context that can clarify ambiguity but cannot override visible image content. |
| `keywords` | array | No | SEO keywords to include only when natural and consistent with visible image content; inclusion is not guaranteed. |
| `language` | string ("af" | "sq" | "am" | "ar" | "hy" | "as" | "ay" | "az" | "bm" | "eu" | "be" | "bn" | "bho" | "bs" | "bg" | "ca" | "ceb" | "zh-hans" | "zh-hant" | "zh-cn" | "zh-tw" | "co" | "hr" | "cs" | "da" | "dv" | "doi" | "nl" | "en" | "en-gb" | "eo" | "et" | "ee" | "fil" | "fi" | "fr" | "fy" | "gl" | "ka" | "de" | "el" | "gn" | "gu" | "ht" | "ha" | "haw" | "he" | "hi" | "hmn" | "hu" | "is" | "ig" | "ilo" | "id" | "ga" | "it" | "ja" | "jv" | "kn" | "kk" | "km" | "rw" | "gom" | "ko" | "kri" | "ku" | "ckb" | "ky" | "lo" | "la" | "lv" | "ln" | "lt" | "lg" | "lb" | "mk" | "mai" | "mg" | "ms" | "ml" | "mt" | "mi" | "mr" | "mni-mtei" | "lus" | "mn" | "my" | "ne" | "no" | "ny" | "or" | "om" | "ps" | "fa" | "pl" | "pt" | "pa" | "qu" | "ro" | "ru" | "sm" | "sa" | "gd" | "nso" | "sr" | "st" | "sn" | "sd" | "si" | "sk" | "sl" | "so" | "es" | "su" | "sw" | "sv" | "tl" | "tg" | "ta" | "tt" | "te" | "th" | "ti" | "ts" | "tr" | "tk" | "ak" | "uk" | "ur" | "ug" | "uz" | "vi" | "cy" | "xh" | "yi" | "yo" | "zu") | No | Supported output language code, such as 'en', 'en-gb', or 'zh-hans'; omit to use the language configured on the AltTextLab account. |
| `ecommerce` | object | No | Optional product metadata; providing any field enables e-commerce generation mode. |
| `image_url` | string | Yes | Direct HTTPS URL of a public image that is accessible without authentication or redirects. |
| `custom_fields` | object | No | Optional metadata returned unchanged by AltTextLab and not used to generate the alt text. Supports at most 30 entries; keys may contain up to 70 characters and values up to 250 characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Credits

**Slug:** `ALT_TEXT_LAB_GET_ACCOUNT_CREDITS`

Return the connected AltTextLab account's plan, activation state, and current generation credit balance.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
