Translate
lingvanex.translate
ActionBusiness appsconnection required
Calls the Lingvanex API with the connection's credentials.
Translate text or HTML with the native Lingvanex API.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Lingvanex
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- base_url, compat_base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
6 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
to The language to translate into, as a Lingvanex 'language_COUNTRY' code such as de_DE or es_ES. | string | Yes | — | — | de_DE |
text The text to send, as a single string. Use 'texts' instead to send several strings in one call. | string | No | — | — | Hello, world! |
texts Several strings to send in one call, as a JSON array. When it is set it replaces 'text' and the response carries one entry per string. | array | No | — | ≥ 1 characters; array of string | ["Hello, world!","Good morning"] |
from The language the text is written in, as a 'language_COUNTRY' code; leave it blank to let Lingvanex detect the language. | string | No | — | — | en_GB |
translate_mode Whether the input is plain text or HTML whose markup must be preserved around the translated words. | string | No | text | one of "text", "html" | — |
enable_transliteration Ask Lingvanex to add sourceTransliteration and targetTransliteration fields to the result. | boolean | No | false | — | — |
- At least one of text, texts must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"enable_transliteration": false,
"from": "en_GB",
"text": "Hello, world!",
"texts": [
"Hello, world!",
"Good morning"
],
"to": "de_DE",
"translate_mode": "text"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
to The language the text was translated into. | string | — |
from The source language that was sent, empty when it was auto-detected. | string | — |
translation The first translated string. | string | — |
translations Every translated string, in the order sent. | array | — |
count How many translated strings came back. | number | — |
result Lingvanex's own 'result' value, exactly as returned. | any | — |
{
"count": 0,
"from": "",
"result": null,
"to": "",
"translation": "",
"translations": []
}Related Lingvanex nodes
See Translate run in a workflow.
In a technical demo we add the Lingvanex connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.