{"ok":true,"service":"CardTion (card.tion.kr) — 카드뉴스 이미지 생성 플랫폼","auth":"HTTP 헤더 X-API-KEY (발급: 관리자). 브라우저 에디터는 키 없이 동작(렌더는 IP당 일일 제한).","flow":"① POST /api/v1/copy 로 주제→덱 JSON 생성(AI) ② 필요시 덱 JSON 수정 ③ POST /api/v1/render 로 PNG 출력. 또는 POST /api/v1/generate 한 번으로 ①+③. 블로그 대표이미지(1장)는 POST /api/v1/thumbnail 원샷.","highlight_syntax":"headline 안의 [대괄호] 구간이 액센트 색으로 강조된다. 예: \"지금부터 [실천]하세요\"","animations":{"none":"없음","rise":"떠오르기","fade":"페이드","zoom":"줌 인","slide":"슬라이드 인"},"layer_schema":{"설명":"슬라이드당 자유 레이어 최대 12개. 배열 순서 = z순서(뒤에 올수록 위). 좌표 x,y 와 크기 w,h 는 카드 대비 %, 텍스트 size 는 px(카드 폭 1080 기준). rotate(-180~180), opacity(0.05~1), hidden(true=렌더 제외) 공통. 렌더/미리보기 동일 적용.","text":"{type:\"text\", text, x, y, w, size, weight:400|500|700|800|900, color:\"#fff\", align:left|center|right}","image":"{type:\"image\", url:\"https://...\", x, y, w, h(0=비율자동), radius:0~50}","shape":"{type:\"shape\", shape:\"rect|circle|line\", x, y, w, h, fill:\"#FFC845\", radius}"},"ratios":{"1:1":"1:1 (정방형)","4:5":"4:5 (인스타그램)","9:16":"9:16 (스토리/릴스)"},"presets":{"photo-dark":{"label":"포토 다크","desc":"사진/그라디언트 배경 + 반투명 패널 (시안 기본)"},"white-card":{"label":"화이트 카드","desc":"밝은 배경, 진한 텍스트, 액센트 바"},"badge-title":{"label":"뱃지 타이틀","desc":"네이비 배경, 큰 액센트 뱃지"},"bold-white":{"label":"볼드 화이트","desc":"흰 배경, 초대형 검정 헤드라인, 형광펜 하이라이트"},"noir-gold":{"label":"누아르 골드","desc":"블랙 + 골드 라인, ROBOTION 시그니처"}},"accents":["#FFC845","#FF5A3C","#4DA3FF","#39D98A","#B388FF","#FF7BAC","#C9A227","#00C4CC"],"deck_schema":{"title":"string(100)","topic":"string(200)","brand":"string(60)","product":"string(60)","ratio":"1:1 | 4:5 | 9:16","style":{"preset":"photo-dark | white-card | badge-title | bold-white | noir-gold","accent":"#RRGGBB","overlay":"0~0.85 (사진 위 어두운 스크림)","anim":"none | rise | fade | zoom | slide (웹 미리보기 등장 효과)"},"design_class(style)":{"1":"클래스 1 — 시안 템플릿 (뱃지·패널·프레임 자동, 원본 디자인 고정)","2":"클래스 2 — 자유 레이어 (모든 요소를 레이어로 직접 구성)"},"slides[]":{"구조":"클래스 1: badge/headline/body 쇼트핸드가 시안 템플릿(뱃지·패널·프레임)으로 렌더 + layers 는 그 위에. 클래스 2: 완전 레이어 기반(쇼트핸드는 자동으로 텍스트 레이어로 변환).","role":"cover | content | closing (AI 문구 생성용 메타)","badge/headline/body":"클래스 1 템플릿 콘텐츠. headline 은 [강조] 문법 지원.","align":"클래스 1 전용: center | left | bottom","show_pagenum":"bool — 하단 페이지 번호","bg":{"gradient":"{type:\"gradient\", value:\"linear-gradient(...)\"}","color":"{type:\"color\", value:\"#0a2540\"}","url":"{type:\"url\", url:\"https://... (jpg/png/webp)\"}","builtin":"{type:\"builtin\", id:\"grad-ember\"} — GET /api/v1/backgrounds 의 id"},"layers[]":"레이어(텍스트/이미지/도형) — layer_schema 참조","shorthand":"layers 없이 badge/headline/body 문자열만 보내면 서버가 자동으로 텍스트 레이어로 변환해준다(간편 모드)."}},"endpoints":{"GET /api/v1/schema":"이 문서","GET /api/v1/presets":"스타일 프리셋 목록","GET /api/v1/backgrounds?cat=다크":"배경 라이브러리(내장 그라디언트/단색 + PDS 포토(키 설정 시))","POST /api/v1/copy":"{topic*, reference?, brand?, product?, direction?(방향·톤 지시문), slides?:auto|1~10(숫자면 정확히 그 장수, 1=단독 카드), ratio?, auto_design?:true(AI가 preset·accent·배경까지 결정 — 원클릭)} → {deck, used_ai, design_applied}","POST /api/v1/decks":"{deck} → {id, edit_token} 저장","GET /api/v1/decks/{id}":"덱 조회","PUT /api/v1/decks/{id}":"{deck, edit_token?} 수정 (API키 또는 edit_token)","POST /api/v1/preview":"{deck, slide:0} → HTML (렌더와 동일 마크업, 미리보기용)","POST /api/v1/render":"{deck | deck_id, slides?:[1,2]} → {images:[{no,url}], zip} PNG 1080px","POST /api/v1/generate":"{topic*, reference?, direction?, auto_design?:true, ...copy 옵션, save?:true, publish?:{tags,description}} → copy+render(+PDS 업로드) 원샷 {deck, deck_id, images[{url,pds}], zip} — 주제·장수(·방향)만으로 완성본까지 한 번에","POST /api/v1/thumbnail":"{topic*, direction?, reference?, brand?, ratio?:\"1:1\", variants?:1~4(서로 다른 후킹 각도 시안 수), save?:true, publish?:{tags,description}, deliver?:{url,field,filename,headers,fields}} → 🎯 네이버 블로그용 후킹 썸네일 1장 원샷 — AI가 후킹 문구(숫자/궁금증/손실회피/타깃호명)+preset·accent·배경까지 결정, 시안별 PNG {thumbs:[{variant,headline,url,download_url,deck_id,edit_token,deck,pds?,delivery?}]}","GET /api/v1/download?f=renders/...&name=파일명.png":"렌더 결과 강제 다운로드(Content-Disposition 첨부, 파일명 지정) — 응답의 download_url 이 이 형식","POST /api/v1/deliver":"{image_url*, target:{url*(공인 http/https), field?:\"file\", filename?, headers?:{Authorization:\"...\"}, fields?:{추가 폼필드}}} → 이미지를 원하는 위치로 multipart 업로드(워드프레스 미디어·자체 서버 등). thumbnail/generate 의 deliver 옵션과 동일 동작 — 1년 플랜 전용","POST /api/v1/upload":"multipart file | JSON {image_base64} | JSON {image_url} → {url} (이미지 업로드, 8MB, jpg/png/webp)","POST /api/v1/publish":"{deck_id|deck, slides?, tags?:[\"경로/태그\"], description?} → 렌더 + pds.tion.kr 업로드 {images[{url,pds:{id,url,thumb_url}}]}","GET /api/v1/guide":"AI 에이전트(클로드코드/코덱스)용 풀패키지 가이드(마크다운) — 디자인 레시피·파이프라인 예시 포함"},"example_curl":"curl -s https://card.tion.kr/api/v1/generate -H 'X-API-KEY: <키>' -H 'Content-Type: application/json' -d '{\"topic\":\"아침 루틴 5가지\",\"slides\":\"auto\"}'"}