# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/flows/flow-components/deepl.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.