Language Weaver Developers Q&A - Recent Threads

RE: SDK/API to Language Weaver Cloud?

Adam LaMontagne — Thu, 19 Mar 2026 08:57:57 GMT

Hi Roger Shu ,
The LW SDK is the preferred method for developing integrations to Language Weaver simply because it makes the development easier. Fundamentally, the SDK is using the same API to communicate with Language Weaver. In any case, I'd like to point you towards the Language Weaver Developer documentation: https://developers.languageweaver.com/api/lw/index.html, where you will also find the SDKs for various languages as well as a Postman collection that can serve as a developer playground to help understand the API endpoints.

All of the methods above support synchronous translation, asynchronous translation and https (recommended). Please share those details with the customer developers.

We also recommend that LW integrations use https headers to identify themselves, making it easier to distinguish integration usage from other types of usage when reporting.

The following headers should be sent with each HTTP request made to Language Weaver.

Trace-App - [REQUIRED] Defines the Application Name for the integration - up to 128 chars

Trace-App-Version - [REQUIRED] Defines the version of the integration. String - up to 128 chars

Trace-App-Meta-Info - [OPTIONAL] Meta information that can be sent from the integration. String - up to 256 chars

SDK/API to Language Weaver Cloud?

Roger Shu — Thu, 05 Mar 2026 01:10:30 GMT

Hi Dev team

Our client’s plan is to establish the connection between their internal content platform with Language Weaver (Cloud) for synchronized translation, and would like to confirm some technical details.

They are evaluating which method - SDK or API - would more proper for their platform and business demands.

I searched but had very limited inforamation from Documentation and WIKI.

Could you please help share your commments or suggest any? Appreciate for your help.

Methods

Support synchronized translation?

Any links to detailed webpage?

Support asynchronous translation?

Any links to detailed webpage?

Support HTTP?
Any links to detailed webpage?

Support HTTPS?
Any links to detailed webpage?

SDK method

Yes？

？

API method

Yes

Synchronous translation - Wiki - Language Weaver - RWS Community

？

Yes

Technical Requirements And Best Practices

Yes

Technical Requirements And Best Practices

Best regards,

Roger

SDK OR API to Language Weaver Cloud

Roger Shu — Tue, 03 Mar 2026 02:45:00 GMT

Hi Dev team

Sorry for another question from the client

The client’s plan is to establish the connection between their internal content platform with Language Weaver (Cloud) for synchronized translation.

I searched but have very limited inforamation. Could you please help share your commments?

Methods

Support synchronized translation? And links?

Support asynchronous translation? And links?

Support HTTP? And links?

Support HTTPS? And links?

SDK method

Yes？

？

API method

Yes

Synchronous translation - Wiki - Language Weaver - RWS Community

？

Yes

Technical Requirements And Best Practices

Yes

Technical Requirements And Best Practices

Best regards,

Roger

RE: SDK OR API to Language Weaver Cloud

Roger Shu — Wed, 18 Mar 2026 09:39:35 GMT

Dear Community fellows,

Could anyone here help on this inforamtion pls? Appreciate for your time.

Regards,

Roger

Language Weaver SDK in java and Spring conflict

Romain Dénarié — Tue, 13 Jan 2026 17:08:49 GMT

I'm trying to use Language Weaver Java SDK, last version (3.1.1, from march 2023)

My application have dependencies on Spring, in a newer version from the one in the SDK, which generates conflict at startup.

Is there a newer version of the SDK, with a more recent version of Spring, or without the dependency on Spring ?

Thanks for your reply

Blank values sending data to the API

Chris Williams — Mon, 30 Sep 2024 16:50:43 GMT

When I use the API to send an array of strings to translate, some of the values are blank (i.e. contain no value). This appears to throw a translation error. However using the Portal blank values are accepted. How can I translate an input with empty values (i.e., "one", "two", "", "three")

RE: Blank values sending data to the API

Madalina Bardocz — Thu, 10 Oct 2024 13:54:58 GMT

Hello Chris,

Apologies for the late response. Sending escaped characters may work fine for majority of language pairs but for some language pairs the quotes may be specific to that type of language (e.g. you will get back these types of quotes « » when you translate the escaped quotes from English to French).

One option you could explore is to set up a unique value (e.g. "BLANK_TRANSLATION_VALUE" or a different string that is unlikely to occur in translation) as a Brand entry. The advantage of the brand is that any brand entry you configure will remain untranslated across all the target languages you translate into, there is no query parameter to add to your api calls as this is a global setting.

To set-up a Brand, as an Admin, you need to go "Settings > Brands > Create Brand > input the brand you'd like to set-up in the "Brand" field then click on Create Brand (the "Comment" field is optional and "Is Seach Pattern" should be ticked only if you set-up a regex-based brand - not applicable for this particular situation).

Look forward to your feedback if this is likely to give you an acceptable solution for your workflow.

Thank you,

Madalina

RE: Blank values sending data to the API

Chris Williams — Wed, 02 Oct 2024 10:27:56 GMT

Sending a character placeholder and dictionary to accommodate the LanguageWeaver API's inability to handle blank or empty input values was an attempt to find a work around. I may have found a better solution by sending escaped quotes (i.e., "\"\"") when a blank field is present on the outgoing translation request. Although not perfect, it does seem to be a little cleaner than trying to parse a unique character string. More testing needs to be done to verify this proposed plan unless you can offer a better way to handle blank values.

RE: Blank values sending data to the API

Chris Williams — Tue, 01 Oct 2024 16:14:37 GMT

I use Postman regularly, however I've not configured it to use our proxy. That said, I've developed a Java SpringBoot application which communicates with the LanguageWeaver API, posting the following Translation Request attributes:

private String sourceLanguageId;

private String targetLanguageId;

private String model;

private String submissionType;

private String inputFormat;

private String[] input;

private String[] dictionaries;

private String translationMode;

private String linguisticOptions;

private int qualityEstimation;

private String requestId;

In this context, the dictionaryID, copied from the "Do Not Translate" id. , is passed to this object which a post request sends this to the LanguageWeaver api. Since I do get a response with translated data, and the not translate variable I've configured using NO_1 TEXT_2 HERE_3, I'm confident the dictionaryId is being transmitted.

I suppose I could try to configure Postman, but would rather work with my source code.

Is this sufficient to diagnose this issue?

RE: Blank values sending data to the API

Madalina Bardocz — Tue, 01 Oct 2024 15:30:59 GMT

Hello Chris,

Could you check how you are passing the dictionaries request parameter and if similar to the below? The "dictionaries" request parameter is a a string array containing dictionary ids. You will need to specify the ID of the dictionary you have set-up.

"dictionaries":["dictionaryID"]

To retrieve the "dictionaryID" from the Language Weaver UI, go to the Dictionary page, click on the dictionary name that you have set-up, then click on "Show details". The dictionary ID will be displayed and you can copy it.

I believe you are using our Postman collection, but in case you are not, I am sharing here the link for reference: https://developers.languageweaver.com/developer-tools/postman-collection/lw/index.html

I hope this helps. Look forward to your feedback.

Kind regards,

Madalina

RE: Blank values sending data to the API

Chris Williams — Tue, 01 Oct 2024 14:16:36 GMT

A follow-up regarding my proposed solution to use a dictionary and BLANK TRANSLATION VALUE to address a blank. As I've noted in (+) Dictionary is not in drop down - Forum - Language Weaver - RWS Community I'm able to use a dictionary that contains BLANK TRANSLATION VALUE. Using the web portal I can enter:

BLANK TRANSLATION VALUE
New
Update
Delete

and Indeed, BLANK TRANSLATION VALUE is not translated and is returned to the portal ui with the value specified in the dictionary.

However, if I include the dictionary ID in my API translation request, the Language Weaver API translates the dictionary value and not the text specified in the dictionary. If I contort the return value with special characters and numbers (i.e., NO_1 TEXT_2 HERE_3) the response I get from the API will return NO_1 TEXT_2 HERE_3.

Is there something I'm not aware of when using a dictionary ID with an API translation request?

RE: Blank values sending data to the API

Chris Williams — Tue, 01 Oct 2024 11:54:58 GMT

Hi Madalina,

Here is a typical language property file with key value pairs that includes an element that does not contain a value:

UNKNOWN=
NEW=New
UPDATE=Update
DELETE=Delete

When this language property file is parsed into into an array, the values are ["", "New", "Update", "Delete"] , which as you have noted throws an error when the data object is posted to the API. I suspected this might be an anomaly of the API, so I attempted to introduce a unique value into the blank, prior to posting, (i.e. ["BLANK TRANSLATION VALUE", "New", "Update", "Delete"] ), then use the Dictionary to replace BLANK TRANSLATION VALUE with BLANK TRANSLATION VALUE, and then replace BLANK TRANSLATION VALUE in the API response with a blank field in the language property file. Unfortunately, the Dictionary function isn't working for me and I have another support question that is trying to resolve that issue.

I would be open to any suggestion you may have.

Thanks,

Chris

RE: Blank values sending data to the API

Madalina Bardocz — Tue, 01 Oct 2024 11:36:34 GMT

Hello Chris,

You are indeed receiving that error message via the API because one of the elements in the array is empty. The reason it works in the UI is because it uses a different type of submission/input format, it treats the text you put in the UI as a full string, not an array of elements.

Can you please provide more details on your use case and requirements either via this post or I can reach out by email with some proposed timings and we can have a quick sync.

Look forward to your feedback.

Thank you,

Madalina

RE: API Access

Chris Williams — Thu, 21 Dec 2023 14:59:29 GMT

Great, I will try it out

API Access

Chris Williams — Mon, 18 Dec 2023 20:34:49 GMT

How do I determine what Language Weaver subscription level I have? I want to find out if I have access to the Language Weaver API for accessing your cloud services. According to the Language Weaver documentation:

In order to get started developing on the cloud-based Language Weaver API, you need to create an account by visiting https://portal.languageweaver.com and signing up to plan that supports API integration. Once there, you can access your API credentials from the settings in your account.

If you’re already a Language Weaver customer with a valid subscription, you can manage your API credentials from https://portal.languageweaver.com/settings/api-credentials .

I'm a Language Weaver customer but how do I determine if I have a plan that supports API Integration.

RE: API Access

Lenka Denemark — Thu, 21 Dec 2023 14:56:20 GMT

Hello Chris,

API integration is supported in your account. Your Admin users can create up to five API credentials to be used in integrations.

If you do not have the Admin role, you can ask your account Admin to create the API credentials for you. They would go to Settings/API Credentials, create API credentials and share them with you.

I hope this information is helpful. Please let me know if you have any other questions.

Best regards,

Lenka

RE: Language Weaver Edge - Using it locally to integrate it with Docker

Arnaud Simon — Fri, 23 Jun 2023 07:32:27 GMT

Hi Ben!

Yes, Language Weaver Edge is designed to run locally, on-premise - and it supports multiple deployment types:

You can deploy the application and the Language Pairs on Windows or Linux operating systems
It can be deployed on bare metals servers, Virtual Machines or using containers.

For Containers, you have 2 options:

build your own docker image and run it using docker compose (we have building scripts available)
or use our Kubernetes deployment package (with pre-defined images and customizable Helm Charts)

For the integration part, you can use the RESTful API, which is documented at https://developers.languageweaver.com/api/lw-edge/index.html .

We also provide additional options such as SDKs (Java, JavaScript, .NET) and embedded API (C++/.NET)

Feel free to get in touch with our support or speak with one of our account managers to get access to the Language Weaver Edge software and start integrating it.

And if you have any further question, feel free to use the forum.

Thank you!

Language Weaver Edge - Using it locally to integrate it with Docker

Ben Ha — Wed, 21 Jun 2023 18:45:19 GMT

Hey guys! Hope you're doing well.

Read this today in your docs:

"Language Weaver Edge (formerly known as SDL Machine Translation Edge) 8 features a REST API that exposes the functionality of Edge to any HTTP client. It uses predictable, resource-oriented URLs as well as standard HTTP verbs and response codes. CORS is supported, allowing client-side web applications to make cross-domain AJAX requests to the API. The majority of the endpoints return JSON, while a few return a base64-encoded string or XML.

The REST API is served on the controller host at its own port. To find out the API server host and port, log in to the Language Weaver Edge Web GUI as an admin user and click to [Username] > My Account. For the purposes of this documentation, we will reference an example server running at the host controller-host and port 8001, with HTTPS enabled, so the base URL for the REST API will be:

https://controller-host:8001/

Throughout the documentation, we will be using curl as our HTTP client to illustrate various interactions with the REST API. Keep in mind that, regardless of HTTP client, it is always a good idea to url-encode data that will be consumed by the API to ensure the integrity of the requests."

My question is simple - is it possible to use the Language Weaver Edge service locally? I mean, something like a `docker` container.

I would like to know this because we're trying to integrate this service with a Golang processing application running on a docker container.

Thanks in advance!

Using Language Weaver - Automated Web Page Translation

Kevan Stranges — Thu, 09 Feb 2023 15:13:05 GMT

Hello,

I was wondering if there was a way to integrate Language Weaver to translate web pages on the fly similar to the Google translate feature?

Essentially something I can send as HTML, receive back and then just replace into the webpage, avoiding html classes like "no-translation" or something along those lines?

If so, is there example JS to support this API?

Thanks

Kevan

RE: Using Language Weaver - Automated Web Page Translation

Arnaud Simon — Mon, 27 Feb 2023 09:19:12 GMT

Hello Kevan,

We are providing code samples together with the SDKs that Lenka mentioned in her reply (https://developers.languageweaver.com/developer-tools/sdk/index.html).

Code samples are available from GitHub - for example the JavaScript code samples can be found at https://github.com/RWS/languageweaver-sdk-samples/tree/main/javascript

You can find code samples for different implementations (backend or browser).

In order to offer web page translation from your own web app, you will have to implement the UI part, but everything else, from language detection to html translation can be done with predefined operations available in the SDK.

I hope this is helpful. The team is happy to get feedback on the SDK and hear from specific capabilities that our developers community would like to see implemented next.

Thank you!

RE: Using Language Weaver - Automated Web Page Translation

Lenka Denemark — Wed, 15 Feb 2023 22:14:12 GMT

Hello Kevan,

Are you trying to build an integration, or do you simply need to have a quick way to translate web sites? I assumed it was the former, but I also wanted to let you know that Language Weaver comes with browser plug-ins for Google Chrome, MS Edge, and Mozilla Firefox that provide on-the-fly machine translation of web pages.

Can you please describe what you are trying to achieve?

Best regards,

Lenka

RE: Using Language Weaver - Automated Web Page Translation

Kevan Stranges — Tue, 14 Feb 2023 17:28:50 GMT

Is there functions that have been prebuilt at all to help translate a page, as opposed to completely starting from scratch?

RE: Using Language Weaver - Automated Web Page Translation

Lenka Denemark — Fri, 10 Feb 2023 20:41:10 GMT

Hello Kevan,

It is possible to integrate Language Weaver to provide web site translation on the fly. If you are interested in building such integration, please refer to the Language Weaver Software Development Kit available at this link.

https://developers.languageweaver.com/developer-tools/sdk/index.html

I hope these resources will be helpful. Kindly let us know if you have any questions of if you need any further assistance.

Best regards,

Lenka

Language Weaver - Reporting via the API?

Kris Gormley — Tue, 23 Nov 2021 09:54:50 GMT

Hi all,

Based on a customer question, I created a very brief article explaining that exposing reporting data in our Language Weaver API is currently planned for January 2022.

https://gateway.rws.com/csm?id=kb_article_view&sysparm_article=KB0025099

Thanks!
Kris

API documentation, SDKs and code samples

Gerhard Kordmann — Wed, 25 Mar 2020 09:28:26 GMT

If you want to integrate Machine Translation into your own workflow, here is some handy information:

Language Weaver Cloud API documentation is here: Language Weaver Cloud API

Language Weaver Edge API documentation is here: Language Weaver Edge API

In the Developer Tools section of the API documentation, you can find:

For Python and PHP code samples, you can find them in the Code Library