AltTextify icon

AltTextify

Generate alt text using AltTextify API

Actions2

Overview

This node integrates with the AltTextify API to generate descriptive alt text for images. It is designed to help users automatically create SEO-friendly and accessible alternative text for images by providing an image URL and optional contextual information such as language, keywords, product name, and brand name.

Common scenarios where this node is beneficial include:

  • E-commerce platforms needing to generate alt text for product images to improve SEO and accessibility.
  • Content creators or marketers who want to automate alt text generation for images in multiple languages.
  • Web developers aiming to enhance website accessibility without manually writing alt text.

For example, a user can input a product image URL along with the product and brand names, specify the desired language (e.g., German), and provide relevant keywords. The node will then return optimized alt text suitable for that context.

Properties

Name Meaning
Image URL A publicly accessible URL of the image in JPEG, PNG, GIF, WEBP, or BMP format to generate alt text for.
Language ISO 639-1 language code specifying the language of the generated alt text. Defaults to English (en).
Keywords Comma-separated list of English keywords/phrases to optimize the alt text for SEO. Only one or two are used per output.
Product Name [Ecommerce] Name of the product to be included in the alt text, useful for e-commerce contexts.
Brand Name [Ecommerce] Brand name to be included in the alt text, enhancing product description relevance.

Output

The node outputs JSON data containing the generated alt text returned from the AltTextify API. The structure is:

{
  "alt_text": "Generated descriptive alt text string"
}

If an error occurs during processing, the output JSON will contain an error field with the error message.

The node does not output binary data.

Dependencies

  • Requires an API key credential for the AltTextify API.
  • The node makes HTTP POST requests to https://api.alttextify.net/api/v1/image/url.
  • The API key must be configured in n8n credentials before using the node.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication errors.
    • Providing an inaccessible or invalid image URL may result in API errors or empty alt text.
    • Incorrect language codes might lead to unexpected language output or fallback to English.
    • Keywords must be in English; otherwise, they may be ignored or reduce SEO effectiveness.

  • Error messages:

    • Errors returned from the API are captured and output as { "error": "message" }.
    • Network or request failures will also appear as error messages in the output.

  • Resolutions:

    • Verify the API key is correctly set and active.
    • Ensure the image URL is publicly accessible and points to a supported image format.
    • Use valid ISO 639-1 language codes.
    • Provide keywords in English only.

Links and References

Discussion