> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/api-en/back-office-api-reference/system-bo-api/ai-multilingual-translation.md).
# AI Multilingual Translation
## Perform AI Multilingual Translation
> \## Function Description\
> Translates multiple fields of the multilingual registration popup at once.\
> \
\
\
> \---\
> \## Detailed Description\
> \* The source language is the BO operator's current i18n screen language (\`sourceLangCd\`).\
\
\
> \* The target language is the langCd selected in the multilingual popup (\`targetLangCd\`).\
\
\
> \* Translates each value in \`fields\` according to its type (plain | html). For html, tags/attributes/images/links are preserved and only text nodes are translated.\
\
\
> \* Brand names, product names, proper nouns, SKUs, numbers, and URLs are preserved.\
\
\
> \* The response returns the translated text with the same field key structure.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"AiTranslateRequest":{"type":"object","description":"AI Multilingual Translation Request","properties":{"sourceLangCd":{"type":"string","description":"Source (reference) language code. Same as BO i18n.currentLang. Example: ko, en, ja, zh"},"targetLangCd":{"type":"string","description":"Target language code. The langCd selected in the multilingual registration popup. Example: en"},"fields":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/FieldSpec"},"description":"Field map to translate. key=field name, value={value, type}"}}},"FieldSpec":{"type":"object","description":"Field Value and Type","properties":{"value":{"type":"string","description":"Original Text"},"type":{"type":"string","description":"Text type: plain | html"},"maxLength":{"type":"integer","format":"int32","description":"Optional value. Maximum length limit"}}},"AiTranslateResult":{"type":"object","description":"AI Multilingual Translation Result","properties":{"fields":{"type":"object","additionalProperties":{"type":"string"},"description":"Translated field map. key=field name, value=translated text"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/common/ai/translate":{"post":{"tags":["AI Multilingual Translation"],"summary":"Perform AI Multilingual Translation","description":"## Function Description\nTranslates multiple fields of the multilingual registration popup at once.\n
\n---\n## Detailed Description\n* The source language is the BO operator's current i18n screen language (`sourceLangCd`).
\n* The target language is the langCd selected in the multilingual popup (`targetLangCd`).
\n* Translates each value in `fields` according to its type (plain | html). For html, tags/attributes/images/links are preserved and only text nodes are translated.
\n* Brand names, product names, proper nouns, SKUs, numbers, and URLs are preserved.
\n* The response returns the translated text with the same field key structure.\n","operationId":"translate","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiTranslateRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiTranslateResult"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```