> 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"}}}}}}}}}
```