FluentC Translate icon

FluentC Translate

Translate text or HTML using FluentC AI
Join our community

Overview

The FluentC Translate node provides text or HTML translation using the FluentC AI service. It supports both synchronous (real-time) and asynchronous (batch) translation modes, making it suitable for translating small snippets quickly or handling larger content efficiently.

Common scenarios include:

  • Translating user-generated content or documents in real-time for immediate display.
  • Processing large volumes of text asynchronously to avoid timeouts or performance issues.
  • Automatically detecting source language or specifying it explicitly.
  • Handling different input formats such as plain text, HTML, or JSON.

Practical examples:

  • Quickly translating a chat message from one language to another in a customer support workflow.
  • Batch translating product descriptions or articles overnight and retrieving results once ready.
  • Translating HTML email templates while preserving markup structure.

Properties

Name Meaning
Mode Choose translation processing mode: Real-time (synchronous, faster for small content) or Batch (asynchronous, better for large content).
Input Text or HTML content to be translated (maximum 100,000 bytes).
Input Format Format of the input content: Text, HTML, or JSON.
Target Language Select the target language code for translation (e.g., "en" for English). Required.
Source Language Select the source language code or leave empty for auto-detection.
Additional Fields Optional fields including:
- Max Polling Attempts (number of retries for batch jobs, default 60)
- Manage Languages notice with link to enable more languages

Output

The node outputs a JSON object containing the translation result along with metadata:

  • For Real-time mode, the output includes the translated content directly.
  • For Batch mode, the node polls until the translation job completes and then outputs the final result.
  • The output JSON also contains the original parameters used (mode, input_format, target_language, and optionally source_language).
  • If an error occurs, the output JSON will contain an error field describing the issue.

The node does not output binary data.

Dependencies

  • Requires an API key credential for FluentC AI service authentication.
  • Makes HTTP requests to FluentC endpoints:
    • https://dashboard.fluentc.io/ai_agent/translate for submitting translation requests.
    • https://dashboard.fluentc.io/ai_agent/results for polling batch job results.
    • https://dashboard.fluentc.io/ai_agent/languages to load supported languages.
  • The node uses n8n's built-in HTTP request helper with authentication.

Troubleshooting

  • Input size limit exceeded: The node throws an error if the input content exceeds 100,000 bytes. To fix, reduce input size or switch to batch mode.
  • Batch translation timeout: If the batch job does not complete within the maximum polling attempts, an error is thrown. Increase the max polling attempts or check network/API status.
  • Batch translation failed: If the batch job status returns "failed", the node reports the error message from the API.
  • Language not enabled: If a selected language is not enabled for your API key, the node shows a notice linking to https://www.fluentc.io to enable additional languages.
  • Authentication errors: Ensure the API key credential is correctly configured and valid.
  • Network or API errors: Check connectivity and FluentC service status.

Links and References

Discussion