> 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/undefined-27.md).

# 공통 멀티모달 카피

## 임시 이미지 업로드

> \## 기능 설명\
> AI 카피 생성용 임시 이미지를 업로드합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* \`toneHint\` 에 따라 도메인별 prefix(\`files/temp/{kind}/...\`) 로 저장됩니다.\<br>\<br>\
> \* goods → GOODS, plan → DISPLAY, event → MARKETING, cs → CUSTOMER\_SERVICE, 미지정 → ETC.\<br>\<br>\
> \* 응답으로 받은 \`tempImageUrl\` 을 \`generate\` 요청에 그대로 전달합니다.\<br>\<br>\
> \* S3 \`files/temp/\` prefix 의 라이프사이클 정책에 따라 일정 시간 후 자동 만료됩니다.<br>

```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":{"AiImageCopyUploadResponse":{"type":"object","description":"공통 멀티모달 카피 임시 이미지 업로드 응답","properties":{"tempImageUrl":{"type":"string","description":"업로드된 이미지의 CDN URL"},"fileName":{"type":"string","description":"원본 파일명"}}},"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/image-copy/upload-temp/":{"post":{"tags":["공통 멀티모달 카피"],"summary":"임시 이미지 업로드","description":"## 기능 설명\nAI 카피 생성용 임시 이미지를 업로드합니다.\n<br><br>\n---\n## 상세 내용\n* `toneHint` 에 따라 도메인별 prefix(`files/temp/{kind}/...`) 로 저장됩니다.<br><br>\n* goods → GOODS, plan → DISPLAY, event → MARKETING, cs → CUSTOMER_SERVICE, 미지정 → ETC.<br><br>\n* 응답으로 받은 `tempImageUrl` 을 `generate` 요청에 그대로 전달합니다.<br><br>\n* S3 `files/temp/` prefix 의 라이프사이클 정책에 따라 일정 시간 후 자동 만료됩니다.\n","operationId":"uploadTemp","parameters":[{"name":"toneHint","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiImageCopyUploadResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 임시 이미지 업로드

> \## 기능 설명\
> AI 카피 생성용 임시 이미지를 업로드합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* \`toneHint\` 에 따라 도메인별 prefix(\`files/temp/{kind}/...\`) 로 저장됩니다.\<br>\<br>\
> \* goods → GOODS, plan → DISPLAY, event → MARKETING, cs → CUSTOMER\_SERVICE, 미지정 → ETC.\<br>\<br>\
> \* 응답으로 받은 \`tempImageUrl\` 을 \`generate\` 요청에 그대로 전달합니다.\<br>\<br>\
> \* S3 \`files/temp/\` prefix 의 라이프사이클 정책에 따라 일정 시간 후 자동 만료됩니다.<br>

```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":{"AiImageCopyUploadResponse":{"type":"object","description":"공통 멀티모달 카피 임시 이미지 업로드 응답","properties":{"tempImageUrl":{"type":"string","description":"업로드된 이미지의 CDN URL"},"fileName":{"type":"string","description":"원본 파일명"}}},"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/image-copy/upload-temp":{"post":{"tags":["공통 멀티모달 카피"],"summary":"임시 이미지 업로드","description":"## 기능 설명\nAI 카피 생성용 임시 이미지를 업로드합니다.\n<br><br>\n---\n## 상세 내용\n* `toneHint` 에 따라 도메인별 prefix(`files/temp/{kind}/...`) 로 저장됩니다.<br><br>\n* goods → GOODS, plan → DISPLAY, event → MARKETING, cs → CUSTOMER_SERVICE, 미지정 → ETC.<br><br>\n* 응답으로 받은 `tempImageUrl` 을 `generate` 요청에 그대로 전달합니다.<br><br>\n* S3 `files/temp/` prefix 의 라이프사이클 정책에 따라 일정 시간 후 자동 만료됩니다.\n","operationId":"uploadTemp_1","parameters":[{"name":"toneHint","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiImageCopyUploadResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 공통 멀티모달 카피 생성

> \## 기능 설명\
> 제목 + 이미지(임시 업로드된 URL) 를 입력 받아 상세설명·간단설명·SEO 키워드·이미지 코칭·A/B 변형 초안을 생성합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 출력 키는 요청의 \`expectedKeys\` 배열로 선언합니다. 워크플로우는 선언된 키만 채워서 응답합니다.\<br>\<br>\
> \* 도메인 톤은 \`toneHint\` 로 분기합니다 (goods | plan | event | cs | null).\<br>\<br>\
> \* 운영자가 검수 후 적용하며, 자동 발행은 수행하지 않습니다.\<br>\<br>\
> \* 응답은 \`{ fields: { \[key]: string | string\[] | object } }\` 구조입니다.<br>

```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":{"AiImageCopyRequest":{"type":"object","description":"공통 멀티모달 카피 요청","properties":{"toneHint":{"type":"string","description":"도메인 톤 힌트. goods | plan | event | cs | null. 미지정 시 일반 격식체."},"title":{"type":"string","description":"제목 텍스트. 등록 화면의 상품명/기획전명/이벤트명 등.","minLength":1},"tempImageUrls":{"type":"array","description":"임시 업로드된 이미지 URL 목록. /upload-temp 응답으로 받은 값들. 대표이미지 + 추가이미지(0~N) 순서.","items":{"type":"string"},"minItems":1},"langCd":{"type":"string","description":"언어 코드. 기본 ko."},"expectedKeys":{"type":"array","description":"기대 출력 키 배열. xgen은 이 키만 채워서 응답한다.","items":{"type":"string"},"minItems":1},"addText":{"type":"string","description":"선택. 운영자 추가 메모."},"brandNm":{"type":"string","description":"선택. 브랜드명. LLM 이 브랜드 특성(톤·타깃·가치관) 을 카피에 자연스럽게 반영하도록 활용한다."},"existingDescription":{"type":"string","description":"선택. 운영자가 이미 작성한 상품 상세 내용(HTML 가능). 비어있지 않으면 새로 작성하지 않고 그 내용을 base 로 개선·보완한다."},"outputFormats":{"type":"object","additionalProperties":{"type":"string"},"description":"선택. 출력 키별 포맷 힌트. 키 → 'html' | 'plain'. 미지정 키는 html 기본. plain 으로 지정된 키는 HTML 태그 없이 작성."},"periodStart":{"type":"string","description":"선택. 진행 시작일(YYYY-MM-DD 또는 ISO). LLM 이 이 시기의 시즌·공휴일·소비 트렌드를 카피에 반영하고, 이미지 시즌 분위기와의 일관성도 검증한다."},"periodEnd":{"type":"string","description":"선택. 진행 종료일(YYYY-MM-DD 또는 ISO). periodStart 와 함께 전달."},"eventContext":{"type":"string","description":"선택. 화면이 자유 형식으로 조립한 도메인 컨텍스트. 예: 이벤트 유형/목적/적용회원 등 메타 정보. LLM 이 카피 톤·구조 결정에 활용."}},"required":["expectedKeys","tempImageUrls","title"]},"AiImageCopyResult":{"type":"object","description":"공통 멀티모달 카피 결과","properties":{"fields":{"type":"object","additionalProperties":{},"description":"필드 맵. key=출력 키, value=string | string[] | object"}}},"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/image-copy/generate/":{"post":{"tags":["공통 멀티모달 카피"],"summary":"공통 멀티모달 카피 생성","description":"## 기능 설명\n제목 + 이미지(임시 업로드된 URL) 를 입력 받아 상세설명·간단설명·SEO 키워드·이미지 코칭·A/B 변형 초안을 생성합니다.\n<br><br>\n---\n## 상세 내용\n* 출력 키는 요청의 `expectedKeys` 배열로 선언합니다. 워크플로우는 선언된 키만 채워서 응답합니다.<br><br>\n* 도메인 톤은 `toneHint` 로 분기합니다 (goods | plan | event | cs | null).<br><br>\n* 운영자가 검수 후 적용하며, 자동 발행은 수행하지 않습니다.<br><br>\n* 응답은 `{ fields: { [key]: string | string[] | object } }` 구조입니다.\n","operationId":"generate","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiImageCopyRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiImageCopyResult"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 공통 멀티모달 카피 생성

> \## 기능 설명\
> 제목 + 이미지(임시 업로드된 URL) 를 입력 받아 상세설명·간단설명·SEO 키워드·이미지 코칭·A/B 변형 초안을 생성합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 출력 키는 요청의 \`expectedKeys\` 배열로 선언합니다. 워크플로우는 선언된 키만 채워서 응답합니다.\<br>\<br>\
> \* 도메인 톤은 \`toneHint\` 로 분기합니다 (goods | plan | event | cs | null).\<br>\<br>\
> \* 운영자가 검수 후 적용하며, 자동 발행은 수행하지 않습니다.\<br>\<br>\
> \* 응답은 \`{ fields: { \[key]: string | string\[] | object } }\` 구조입니다.<br>

```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":{"AiImageCopyRequest":{"type":"object","description":"공통 멀티모달 카피 요청","properties":{"toneHint":{"type":"string","description":"도메인 톤 힌트. goods | plan | event | cs | null. 미지정 시 일반 격식체."},"title":{"type":"string","description":"제목 텍스트. 등록 화면의 상품명/기획전명/이벤트명 등.","minLength":1},"tempImageUrls":{"type":"array","description":"임시 업로드된 이미지 URL 목록. /upload-temp 응답으로 받은 값들. 대표이미지 + 추가이미지(0~N) 순서.","items":{"type":"string"},"minItems":1},"langCd":{"type":"string","description":"언어 코드. 기본 ko."},"expectedKeys":{"type":"array","description":"기대 출력 키 배열. xgen은 이 키만 채워서 응답한다.","items":{"type":"string"},"minItems":1},"addText":{"type":"string","description":"선택. 운영자 추가 메모."},"brandNm":{"type":"string","description":"선택. 브랜드명. LLM 이 브랜드 특성(톤·타깃·가치관) 을 카피에 자연스럽게 반영하도록 활용한다."},"existingDescription":{"type":"string","description":"선택. 운영자가 이미 작성한 상품 상세 내용(HTML 가능). 비어있지 않으면 새로 작성하지 않고 그 내용을 base 로 개선·보완한다."},"outputFormats":{"type":"object","additionalProperties":{"type":"string"},"description":"선택. 출력 키별 포맷 힌트. 키 → 'html' | 'plain'. 미지정 키는 html 기본. plain 으로 지정된 키는 HTML 태그 없이 작성."},"periodStart":{"type":"string","description":"선택. 진행 시작일(YYYY-MM-DD 또는 ISO). LLM 이 이 시기의 시즌·공휴일·소비 트렌드를 카피에 반영하고, 이미지 시즌 분위기와의 일관성도 검증한다."},"periodEnd":{"type":"string","description":"선택. 진행 종료일(YYYY-MM-DD 또는 ISO). periodStart 와 함께 전달."},"eventContext":{"type":"string","description":"선택. 화면이 자유 형식으로 조립한 도메인 컨텍스트. 예: 이벤트 유형/목적/적용회원 등 메타 정보. LLM 이 카피 톤·구조 결정에 활용."}},"required":["expectedKeys","tempImageUrls","title"]},"AiImageCopyResult":{"type":"object","description":"공통 멀티모달 카피 결과","properties":{"fields":{"type":"object","additionalProperties":{},"description":"필드 맵. key=출력 키, value=string | string[] | object"}}},"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/image-copy/generate":{"post":{"tags":["공통 멀티모달 카피"],"summary":"공통 멀티모달 카피 생성","description":"## 기능 설명\n제목 + 이미지(임시 업로드된 URL) 를 입력 받아 상세설명·간단설명·SEO 키워드·이미지 코칭·A/B 변형 초안을 생성합니다.\n<br><br>\n---\n## 상세 내용\n* 출력 키는 요청의 `expectedKeys` 배열로 선언합니다. 워크플로우는 선언된 키만 채워서 응답합니다.<br><br>\n* 도메인 톤은 `toneHint` 로 분기합니다 (goods | plan | event | cs | null).<br><br>\n* 운영자가 검수 후 적용하며, 자동 발행은 수행하지 않습니다.<br><br>\n* 응답은 `{ fields: { [key]: string | string[] | object } }` 구조입니다.\n","operationId":"generate_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiImageCopyRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiImageCopyResult"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
