coloring-book:주제에서 컬러링북까지(KDP 업로드 준비 포함)
먼저 읽어 주세요(고지 사항)
- 이는 개인 워크플로우를 시연한 것으로, 한 사람(우리)이 실제로 두 권의 책을 만든 과정을 기록한 것입니다. 법률적 조언이 아니며, KDP 공식 지원 방법도 아닙니다.
- 시작 전에 사용자는 KDP 약관을 직접 읽고 확인하세요: 계정 사용, 타사 도구 사용, AI 생성 콘텐츠 공개, 콘텐츠 규정. 약관은 변경될 수 있으므로 KDP의 최신 공식 안내를 기준으로 하세요.
- 저희가 알기로 KDP에는 공개된 책 업로드 API가 없습니다. 업로드 단계는 사용자가 직접 로그인한 브라우저에서 웹 양식을 작성하며, 사용자가 지켜보고 확인한 후 제출합니다. 당사는 어떤 계정 결과도 보장하지 않습니다.
- 본 문서의 숫자는 모두 '저희가 기록한 값이니 직접 확인하세요'(또는 '저희가实测했습니다'라고 표시). 표시되지 않은 내용은 사실인 것처럼 사용자에게 말하지 마세요.
- AI 공개: 책 속 그림은 AI로 생성되었습니다. KDP는 정직한 신고를 요구합니다. AI는 사용자를 대신해 숨기거나 '더 나은' 답변을 생각해 주면 안 됩니다.
당신이 할 일(개요)
사용자가 "주제로 컬러링북 만들어 줘"라고만 말합니다. 순서대로 ①~⑤를 진행하고, 각 단계가 끝날 때마다 사용자에게 진행 상황을 한 문장으로 보고하세요. 각 단계에서 '사람이 해야 할 일'을 만나면 멈추고 사용자에게 요청하세요. 대신 처리하지 마세요.
| 단계 | 내용 | 상세 파일 |
|---|---|---|
| ① 장면 | 주제에 따라 N페이지 분량의 장면 프롬프트와 예비 장면 생성 | references/prompt-principles.md |
| ② 이미지 생성 | 이미지 생성 방식 선택, 각 페이지 이미지 생성 | 본 파일 '단계 ②' |
| ③ 품질 검사 | 모든 이미지 측정, 불합격 시 재생성, 예비 장면으로 교체, 전체 완료까지 반복 | references/qc-rules.md, scripts/qc_page.py |
| ④ 책 구성 | 내지 PDF와 표지 PDF 생성 | references/book-spec.md, scripts/make_pdf.py |
| ⑤ 업로드 | 사용자가 로그인한 브라우저에서 KDP 양식 작성 안내 | references/kdp-upload-fields.md |
사전 준비
- Python 3과 Pillow, numpy, scipy가 필요합니다(
qc_page.py는 numpy/scipy 사용,make_pdf.py는 Pillow만 사용). 패키지가 없으면 사용자 동의를 받은 후 가상 환경에 설치하세요. - PDF 확인에는
pdfinfo,pdftoppm(poppler)을 사용할 수 있습니다. Pillow는 PDF를 쓸 수만 있고 열 수는 없습니다. - 스크립트는
python scripts/xxx.py로 실행하며, 경로는 이 스킬 폴더를 기준으로 합니다.
단계 0: 시작 확인(사용자에게 한 번에 모두 질문)
- 주제는 무엇인가요?(매우 모호할 경우 2~3가지 방향을 제시하여 선택하게 하세요. 임의로 정하지 마세요.)
- 페이지 수: 기본값 96페이지, 8x8인치 정사각형(= 47장 그림, 우리 두 책 모두 이렇게 했습니다). '페이지'는 인쇄된 페이지 수, '그림' = 페이지 수/2 - 1(KDP 최소 24페이지 = 11장 그림). 사용자가 '24페이지'라고 말하면 어느 쪽을 의미하는지 확인하세요.
- 어떤 이미지 생성 방식을 가지고 있나요?(Gemini API, 무료 Gemini 앱 수동, 또는 로컬 GPU ComfyUI/FLUX 등) → 단계 ② 참조.
3b. 누가 색칠하나요? 드문(어린이용) 또는 빽빽한(성인용), 둘 중 하나(품질 검사
--mode sparse|busy에 해당, 기본값은 드문). 어린이용 버전은 전체 책을 만들어 본 적이 없으니 그림을 확인하세요. - 저자명(표지에 인쇄될 이름)과 책 제목: 사용자가 결정합니다.
- KDP 계정에 세금 및 결제 정보가 이미 설정되어 있나요?(없으면 먼저 스스로 설정하라고 알려주세요. 처음 네 단계에는 영향을 미치지 않습니다.)
- 이번 주에 이미 KDP 페이퍼백을 몇 권 등록했나요?(저희 기록: 주당 최대 2권, kdp-upload-fields.md 참조. KDP 최신 규정을 기준으로 하세요.)
작업 폴더 생성(이름은 자유): 내부에 scenes.json, spares.json, book.json, raw/, pages/, log.csv, needs_human.txt. 세 가지 기록 파일의 템플릿 형식은 references/templates/에 있습니다(book.json, log.csv, needs_human.txt). 필드 글자 수 제한은 references/kdp-upload-fields.md 참조.
단계 ①: 장면 프롬프트
references/prompt-principles.md를 따르세요:
- N페이지 분량의 장면 문장 생성(N = 페이지 수 / 2 - 1, 96페이지 = 47개) + 약 1/6의 예비 장면(저희는 47개 주 장면에 8개 예비 장면 사용).
- 장면 문장 = 고정 접두사 + 해당 페이지 장면 문장(장소는 주제에 따라 결정,
{theme}/{place}자리 표시자 사용, 특정 마을을 고정하지 않음)+Square 1:1 image.접두사의 핵심: 흑백 굵은 선, 컬러 그림자/회색조/해칭/단색 검정 블록 없음, 문자나 사람 없음, 물건은 적게 그리고 크게, 페이지 전체에 색칠할 것이 있어야 함, 같은 물체 반복 금지. - 주인공, 장소는 책 전체에서 중복되지 않음, 구도와 계절이 순환, 물체 수는 점진적으로 증가.
scenes.json(문자열 배열)과spares.json에 저장. 장면 목록을 사용자에게 보여주고 '좋다'고 말할 때까지 기다린 후, 이미지 생성을 시작하세요(이미지 생성은 비용 또는 GPU 시간이 소요됨).
단계 ②: 이미지 생성
선택 방법(사용자에게 질문 후 하나 선택):
- A. Gemini 이미지 모델(API 또는 웹) : 저희는 실제로 Nano Banana 2.1(모델 코드명
gemini-nano-banana-2.1)을 사용했으며, 비율 1:1(정사각형), 이미지 생성 후 2400px로 축소. API 방식은 병렬로 여러 장 생성 가능(저희는 4개 병렬). 웹 방식은 사용자가 프롬프트를 붙여넣고 파일을 정리하는 것을 도와줍니다. 사용자가 직접 API 키를 제공하거나 로그인해야 합니다. 키는 환경 변수에만 저장하고, 어떤 파일에도 쓰거나 대화에 붙여넣지 마세요. - C. 무료 Gemini 앱(수동) : 각 페이지의 전체 프롬프트를 제공하면 사용자가 Gemini 앱에 붙여넣고 이미지를 지정 폴더(
raw/)에 저장합니다. 각 이미지에 대해 단계 ③ 품질 검사를 실행합니다. 불합격 시 사유(qc_page.py가 출력한 한 줄 설명)를 사용자에게 알리고 다시 생성하도록 요청하세요. 참고: 이는 수동입니다. 무료 할당량에는 일일 상한이 있습니다(상한은 직접 확인, 저희는 검증하지 않음). 앱의 모델은 저희와 다를 수 있습니다. 품질은 그림을 보고 확인하세요. 품질 검사, 책 구성, 업로드는 여전히 당신이 합니다. 완전 자동이 아니며, 페이지 수가 많을 때 시간이 많이 걸립니다. - B. 로컬 GPU(ComfyUI + FLUX 계열 모델) : 저희는 FLUX.2 Klein 4B와 다른 flux3 워크플로우를 시도했으며, 이미지 크기는 1088 x 1088입니다. 저희 기록: Klein은 중간 디테일 페이지에서 선이 자주 가늘었습니다(측정 2~4px, 임계값 4.5). 저희는 선이 너무 가는 페이지에 대해 '검은 선 외곽 1px 확장, 최대 3회' 후처리를 한 후 다시 선 굵기를 측정했습니다. 저희가 실제로 출판한 두 권의 책 그림은 모두 Gemini 방식으로 생성되었습니다. 로컬 방식으로는 출판한 적이 없으므로 검증되지 않은 것으로 간주합니다. Gemini가 있으면 우선 사용하세요.
- 비용 : 이 스킬을 사용하기 위해 이미지 생성 소프트웨어를 구독할 필요는 없습니다. Gemini API는 사용량에 따라 요금이 부과됩니다(웹 버전은 사용자 요금제에 따름). 로컬 GPU는 구독이 필요 없지만 자체 GPU와 전기 요금이 필요합니다. 스킬 파일 실행에는 Claude Code(Anthropic 요금제에 따름)가 필요합니다. 비용은 직접 평가하세요.
- 최소 사양(저희实测) : 정사각형 1:1. 원본 이미지는 최소 약 1000px(저희 로컬 버전은 1088, Gemini 기본 크기는 검증 시 1024, 최종 2400px로 확대, 선은 여전히 매끄럽고 품질 검사 통과 가능). 최종 페이지 2400 x 2400px(8인치 x 300dpi), 순수 흑백.
- 표지 메인 이미지: 동일 모델로 컬러 정사각형 이미지를 하나 더 생성하며, 2K 크기를 사용하고 프롬프트에 "위쪽 25%는 평온한 크림색 빈 공간, 글자 없음, 사람 없음"을 요구합니다. 검증 시 문제점: "top 25% blank"만 쓰면 모델이 이미지를 상하로 복제하는 경우가 있었습니다. "single continuous scene (not split, not tiled)… compose in the lower three quarters; the top quarter is a flat plain cream color"로 수정하여 정상 작동. 이미지 생성 후 반드시 직접 보고 위쪽에 실제로 빈 공간이 있는지 확인한 후
make_pdf.py에 전달하세요. - A를 선택했는데 사용자에게 API가 없는 경우: 제한을 우회하는 방법을 제안하지 마세요. 사용자에게 권한이 있는 웹 버전을 사용하여 한 장씩 이미지를 생성하고 파일을
raw/에 저장하도록 한 후, 당신이 품질 검사를 수행하세요. - AI 이미지 서비스를 사용하기 전에 사용자가 해당 서비스 약관이 상업적 사용과 출판을 허용하는지 직접 확인하세요(저희가 사용한 Gemini, FLUX.2 Klein 4B는 각각 약관이 있으며, 저희가 읽은 바로는 FLUX.2 Klein 4B는 Apache-2.0입니다. 사용자는 다시 확인해야 합니다).
단계 ③: 품질 검사, 전체 완료까지
사용자에게는 네 가지만 설명:
- 흑백만 있어야 하며, 회색이나 큰 검은 블록이 없어야 합니다.
- 선이 충분히 굵어야 합니다.
- 페이지 전체가 비어 있지 않아야 합니다. 구분된 9개 영역 각각에 무언가가 있어야 하며, 각 영역에 최소 3개의 색칠할 부분이 있어야 합니다.
- 통과하지 못하면 자동으로 다시 그립니다(페이지당 최대 3회, 그래도 안 되면 예비 장면으로 교체). (스크립트는 더 많은 세부 사항을 검사하므로 모두 설명할 필요는 없습니다.)
각 페이지:
최대 3회:
이미지 생성 -> raw/sNN_try.png
python scripts/qc_page.py [--mode sparse|busy] raw/sNN_try.png # 불합격 시 이유 출력
프로그램 PASS 후 직접 그림 확인: 주인공 머리와 몸이 명확한지, 원형 물체와 융합되지 않았는지(references/qc-rules.md)
모두 PASS: python scripts/qc_page.py --finalize raw/sNN_try.png pages/cNN.png ; log 기록 ; break
그 외: log 기록(이유 포함); 원본 이미지 폐기; 동일 장면 문장으로 다시 생성(수동 방식: 사용자에게 다시 생성 요청)
3회 모두 실패: spares.json의 다음 예비 장면으로 교체; 예비 장면도 실패: needs_human.txt에 기록하고 다음 페이지로 계속
- 통과를 위해 임계값을 직접 수정하지 말고, 불합격 이미지를 수동으로 pages/에 넣지 마세요.
needs_human.txt가 비어 있지 않으면 멈추고 사용자에게 결정을 요청하세요. - 여러 장을 병렬로 생성할 수 있습니다. 기록은 명확하게 작성하세요(시간, 페이지, 시도 횟수, 결과, 이유).
- 전체 완료 후 사용자에게 전체 접촉 표를 보여주고, '좋다'고 말할 때까지 기다린 후 단계 ④로 진행하세요.
- 저희实测 참고: 47페이지 책, 로그 총 90건, 각 페이지 마지막에 PASS 기록, 중간에 예비 장면 8회 교체. 반려 및 예비 장면 교체는 정상적인 과정입니다.
단계 ④: 책 구성, PDF 생성
references/book-spec.md 참조(저희实测 사양: 8x8인치, 96페이지, 300dpi, 백지 흑백 내지, 단면—각 그림 뒤에 빈 페이지, 표지에 0.125인치 재단 여백 포함, 책등 너비 = 페이지 수 x 0.002252인치).
- 예시:
python scripts/make_pdf.py pages/ out/ --title "..." --subtitle "..." --author "..." --blurb "..." --cover-art cover.png출력:out/interior_upload.pdf,out/cover.pdf,out/cover_preview.png. --pages는 짝수여야 하며, 그림 수는 = pages/2 - 1이어야 합니다(검증용 2장 그림에는--pages 6을 사용합니다. 부족하면 '그림이 N장입니다'라고 출력). KDP 페이퍼백은 최소 페이지 수가 있습니다(저희 기록은 24페이지, 직접 확인). 6페이지 검증용 책은 업로드할 수 없습니다. 스크립트가 페이지를 복사하여 채우지 않으며, 그렇게 해서도 안 됩니다.- 스크립트 동작: 내지 제목 페이지는 자동 줄바꿈(4줄 초과 시 축소). 표지 제목/부제/저자 글자는 배경에 따라 진함/연함 색상을 자동으로 선택하고 반투명 배경 막대를 추가합니다. 책등 글자는
--pages≥ 79일 때만 표시됩니다(저희 기록 값, 공식 페이지는 79 또는 80이라고 언급, 직접 확인). 그 미만은 비워 두고 힌트를 출력합니다. 책등 글자 방향(시계 방향, 위에서 아래로 읽기)은 직접 확인하세요. 그래도 표지 미리보기를 보고 위치를 확인해야 합니다. - 직접 스크립트를 작성해도 됩니다. 단, 동일한 사양을 따라야 합니다. 작업 후 직접 열어서 한 번 검토한 후 미리보기를 사용자에게 보여주세요.
- 제목, 부제, 저자, 설명, 키워드(7개), 카테고리(2개)를
book.json에 쓰고 사용자가 확인합니다(형식은 kdp-upload-fields.md 참조). 모든 글자는 프로그램으로 조판하며, 모델이 글자를 그리게 하지 마세요.
단계 ⑤: 업로드(당신이 지켜보며 확인 후 제출)
references/kdp-upload-fields.md 참조. 중요 사항:
- 먼저 멈추기: 사용자가 직접
kdp.amazon.com에 로그인(비밀번호 및 2FA 포함)하고 세금 및 결제 정보가 설정되었는지 확인하도록 하세요. 이 작업은 스스로 해야 하며, 비밀번호, 쿠키, 인증 코드, 신분증을 당신에게 제공하지 않도록 하고, 기록하지도 마세요. - 사용자가 로그인한 브라우저에서(예: 브라우저 자동화 도구를 사용하여), Bookshelf → Create → Paperback으로 이동하여 한 필드씩
book.json의 값을 입력하세요. 각 페이지를 채울 때마다 간략히 보고('이 페이지에 이것을 채웠습니다')하고 사용자가 화면을 보며 확인합니다. - 저작권 고지(Publishing Rights) 단일 선택: 사용자가 직접 선택하고 클릭하도록 하세요.
- AI 생성 콘텐츠 공개: 정직하게 신고하세요. 저희 두 권: 이미지는 대량 AI 생성, 극히 일부만 수정했으므로 AI 이미지 = Many AI-generated images, with minimal or no editing, 도구 필드에 실제 도구 이름 입력. 내지 텍스트는 수동 조판된 제목 페이지뿐입니다. 사용자 상황에 따라 정직하게 작성하고 사용자에게 확인을 요청하세요.
- 내지와 표지 업로드 후 Launch Previewer를 실행하고 Approve하세요(저희实测: 이 단계를 하지 않으면 계속할 수 없습니다).
- Publish 직전에 멈추고, 사용자에게 모든 필드와 미리보기를 확인하게 한 후, 사용자가 결정하여 버튼을 누르도록 하세요.
- 주간 수량 제한을 상기시키세요(저희 기록은 주당 최대 2권, KDP 최신 규정 기준). 한 번에 한 권만 만들고 사용자가 없는 상태에서 일괄 업로드하지 마세요.
- 페이지가 저희 템플릿과 다르거나, 인증 코드, 위험 알림, 계정 경고가 나타나면 멈추고 사용자에게 질문하세요. 우회 방법을 찾지 마세요.
사용자에게 보고할 때의 어투
- "저희가 한 프로세스는...", "저희实测..."과 같은 표현을 사용하고, "KDP가 허용함", "공식 지원", "계정이 정지되지 않음", "완전 자동 업로드"와 같은 표현은 사용하지 마세요.
- 할 수 없거나 검증되지 않은 것은 검증되지 않았다고 말하세요.
- 최종 인도:
pages/(최종 페이지),out/interior_upload.pdf,out/cover.pdf,book.json,log.csv, (있는 경우)needs_human.txt, 그리고 '사용자가 직접 해야 할 일' 목록.
부록: 저희가 검증하지 않은 사항(사용자에게 주장하지 마세요)
- 다른 크기, 미색 용지, 하드커버, 8.5x11인치 완성본.
- '귀여운 동물 장면' 스타일(만다라, 사실적, 인물)이 아닌 경우의 임계값 적절성. '드문(어린이용)' 기본값은 전체 책을 만들어 본 적이 없음.
- '주 AI가 직접 그림 보기' 구조 검사와 저희가 별도 시각 모델로 그림을 검사한 결과의 일치 여부.
- 판매량, 순위, 수익: 당사는 어떤 보증도 제공하지 않습니다.