Overview
This node provides AI-powered translation services with cultural adaptation for text content. It is designed to translate input text from a source language (auto-detected if not specified) into a target language, optionally tailoring the translation based on audience type, industry context, region, and additional notes.
Common scenarios where this node is beneficial include:
- Translating marketing copy to different languages while adjusting tone for casual or formal audiences.
- Localizing technical documentation with industry-specific terminology.
- Adapting user interface text for specific regions or dialects.
- Providing quick translations of short texts in workflows without manual intervention.
For example, you could use this node to translate a product description from English to Spanish, specifying a formal tone for a legal audience in Spain, ensuring the translation respects local conventions and terminology.
Properties
| Name | Meaning |
|---|---|
| Text | The text string that you want to translate. |
| Target Language | The language code to translate the text into. Options are dynamically loaded supported languages. |
| Additional Options | A collection of optional parameters to customize the translation: |
| - Target Audience | The intended audience style: General, Technical, Casual, or Formal. |
| - Industry | The industry context for specialized terminology: Technology, Healthcare, Finance, Education, Legal, Marketing, E-commerce. |
| - Source Language | The source language code; if left empty, the source language will be auto-detected. |
| - Region | Specific region for localization (e.g., Spain, Mexico, Brazil). |
| - Translation Notes | Extra instructions or context for the translation (e.g., "Keep technical terms in English"). |
Output
The node outputs JSON data containing the translation results. Specifically, the output JSON includes:
translatedText: The translated version of the input text as a string.
If an error occurs during translation, the output JSON will contain an error field with the error message.
Dependencies
- Requires an API key credential for the external AI-powered translation service.
- The node communicates with the translation API endpoint at
https://api.i18nagent.ai(or a custom URL if configured). - The node depends on n8n's HTTP request helper methods to authenticate and send requests to the translation API.
Troubleshooting
Common issues:
- Missing or invalid API credentials will cause authentication failures.
- Unsupported target language codes may result in errors or empty translations.
- Network connectivity problems can prevent reaching the translation API.
- Providing empty or very large text inputs might cause unexpected behavior or timeouts.
Error messages:
- Errors returned by the API are surfaced in the node output under an
errorfield. - If the node fails and "Continue On Fail" is disabled, it throws an operation error indicating the item index and error details.
- Errors returned by the API are surfaced in the node output under an
Resolutions:
- Verify that the API key credential is correctly set up and valid.
- Ensure the target language is selected from the supported list.
- Check network access and proxy settings if applicable.
- Use reasonable text sizes and validate input before sending.
Links and References
- i18n Agent API Documentation (hypothetical link)
- Supported Languages List is dynamically fetched from the API endpoint
/list_supported_languages. - For more information on configuring credentials in n8n, see the official n8n docs on API Credentials.