# DeepL

DeepL is a powerful AI-driven translation service known for its high-quality translations across multiple languages. It provides accurate and context-aware translations, making it a preferred choice for businesses and individuals seeking precise language conversion.

To integrate DeepL with ZBrain Flow:

* Click the '+' button in the Flow and search for DeepL in ZBrain Flow.
* Select the desired action from the available options.

### **How to Connect DeepL to ZBrain Flow?** <a href="#how-to-connect-deepl-to-zbrain-flow" id="how-to-connect-deepl-to-zbrain-flow"></a>

1. **Give a Connection Name** – Enter a name to identify the DeepL connection.
2. **Enter the API Key** – Follow these steps to obtain your DeepL API Key:
   * Log in to your DeepL account.
   * Visit [DeepL Account Summary](https://www.deepl.com/account/summary).
   * Go to the API section and copy your API Key.
3. **Select the API URL** – Choose between the free or paid version.
4. **Click 'Save'** – Your DeepL connection is now set up in ZBrain Flow.

### **Actions Available in ZBrain Flow** <a href="#actions-available-in-zbrain-flow" id="actions-available-in-zbrain-flow"></a>

**Translate Text**

Translate text into a target language.

**How to Configure Translate Text in ZBrain Flow?**

1. **Enter the Text** – Provide the text that needs to be translated.
   * *Note: Only UTF-8 encoded plain text is supported.*
2. **Select Target Language** – Choose from 31 available languages.
3. **Select Source Language** – Specify the original language of the text.
4. **Select Split Sentences Type** – Define how the text should be split before translation:
   * No splitting: Treats the entire input as one sentence.
   * Split on punctuation and newlines.
   * Split on punctuation only (ignoring newlines).
5. **Select Preserve Formatting** – Choose *Yes* or *No* to retain the original formatting.
6. **Select Formality** – Adjust the tone of the translation:
   * *Default*
   * *More formal language*
   * *More informal language*
   * *Fallback to default if the selected formality is unavailable*
7. **Enter Glossary ID** – Specify a glossary to enforce consistent terminology translation.
8. **Select Tag Handling** – Choose how XML or HTML tags should be processed:
   * Enable XML tag handling
   * Enable HTML tag handling
9. **Select Outline Detection** – Choose *Yes* or *No* for automatic XML structure detection.
10. **Enter Non-Splitting Tags** – Provide a comma-separated list of XML/HTML tags that should not be split.
11. **Enter Ignore Tags** – Provide a comma-separated list of XML/HTML tags to be ignored.

***Note:** Click 'f' to add dynamic values wherever needed.*

### **Custom API Call**

Make a custom API call to a DeepL endpoint.

**How to Configure Custom API Call in ZBrain Flow?**

1. **Select the Method** – Choose from *GET, POST, PATCH, PUT, DELETE, or HEAD*.
2. **Add Headers** – Input headers in the provided fields.
   * Authorization headers are automatically injected from your connection.
   * Click '+ Add Item' to add additional headers.
3. **Add Query Parameters** – Input query parameters in the provided fields.
   * Click '+ Add Item' to add additional query parameters.
4. **Enter JSON Body** – Provide the request body in JSON format.
5. **Enter Timeout** – Specify the timeout duration in seconds.

***Note:** Click 'f' to add dynamic values wherever needed.*

<br>