> 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/back-office-api/system-bo-api/ai.md).
# AI 다국어 번역
## AI 다국어 번역 수행
> \## 기능 설명\
> 다국어 등록 팝업의 여러 필드를 한 번에 번역합니다.\
> \
\
\
> \---\
> \## 상세 내용\
> \* 소스 언어는 BO 운영자의 현재 i18n 화면 언어(\`sourceLangCd\`)입니다.\
\
\
> \* 타겟 언어는 다국어 팝업에서 선택된 langCd(\`targetLangCd\`)입니다.\
\
\
> \* \`fields\` 의 각 value 를 type(plain | html)에 맞춰 번역합니다. html 은 태그/속성/이미지/링크를 보존하고 텍스트 노드만 번역합니다.\
\
\
> \* 브랜드명·제품명·고유명사·SKU·숫자·URL은 보존합니다.\
\
\
> \* 응답은 동일한 필드 키 구조로 번역된 텍스트를 반환합니다.
```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 다국어 번역 요청","properties":{"sourceLangCd":{"type":"string","description":"소스(기준) 언어 코드. BO i18n.currentLang 과 동일. 예: ko, en, ja, zh"},"targetLangCd":{"type":"string","description":"타겟 언어 코드. 다국어 등록 팝업에서 선택된 langCd. 예: en"},"fields":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/FieldSpec"},"description":"번역할 필드 맵. key=필드명, value={value, type}"}}},"FieldSpec":{"type":"object","description":"필드 값과 타입","properties":{"value":{"type":"string","description":"원문 텍스트"},"type":{"type":"string","description":"텍스트 타입: plain | html"},"maxLength":{"type":"integer","format":"int32","description":"선택값. 최대 길이 제한"}}},"AiTranslateResult":{"type":"object","description":"AI 다국어 번역 결과","properties":{"fields":{"type":"object","additionalProperties":{"type":"string"},"description":"번역된 필드 맵. key=필드명, value=번역된 텍스트"}}},"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 다국어 번역"],"summary":"AI 다국어 번역 수행","description":"## 기능 설명\n다국어 등록 팝업의 여러 필드를 한 번에 번역합니다.\n
\n---\n## 상세 내용\n* 소스 언어는 BO 운영자의 현재 i18n 화면 언어(`sourceLangCd`)입니다.
\n* 타겟 언어는 다국어 팝업에서 선택된 langCd(`targetLangCd`)입니다.
\n* `fields` 의 각 value 를 type(plain | html)에 맞춰 번역합니다. html 은 태그/속성/이미지/링크를 보존하고 텍스트 노드만 번역합니다.
\n* 브랜드명·제품명·고유명사·SKU·숫자·URL은 보존합니다.
\n* 응답은 동일한 필드 키 구조로 번역된 텍스트를 반환합니다.\n","operationId":"translate","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiTranslateRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiTranslateResult"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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://tech.x2bee.com/api/back-office-api/system-bo-api/ai.md?ask=
```
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.