Coloring Book Engine 문제 해결

생성이 시작되지 않을 때

• API Key Required / Send 버튼 비활성 — AI 키가 설정되지 않았습니다. Projects 화면 → Connect Your AI.
• Prompt is required for generation — 그 페이지에 프롬프트가 없습니다. Plan에서 채우세요.
• Run Rest가 비활성 — 채울 것이 없습니다: 모든 페이지가 완성됐거나 이미 큐에 있습니다.
• Prerequisites Not Ready — 그 단계의 입력이 없습니다(예: 채색에는 프로세싱된 스케치가 필요합니다). 메시지가 먼저 끝내야 할 단계를 알려줍니다.

생성이 멈추거나 실패할 때

• Generation Stopped (2회 연속 실패 후) — 크레딧 보호를 위해 큐가 멈춥니다. 대개 프로바이더 레이트리밋이나 일시 장애가 원인입니다. 잠시 기다렸다가 Run Rest를 누르면 멈춘 곳에서 이어갑니다.
• 429 / 레이트리밋 에러 — 앱은 이미 요청 페이스를 조절하지만, 같은 API 키를 쓰는 다른 도구도 같은 제한을 소모합니다. 다른 도구를 잠시 멈추거나 기다리세요.
• Organization Verification Required — gpt-image-2는 OpenAI 계정의 1회성 인증이 필요합니다. 그동안 생성은 dall-e-3로 자동 계속됩니다. 인증을 마친 뒤 영향받은 페이지를 재시도하세요(스타일 앵커에는 참조 이미지를 지원하는 모델이 필요합니다).
• 한 페이지만 계속 실패 — 그 페이지만 개별 재시도하세요. 계속 실패하면 그 페이지의 프롬프트를 살짝 바꿔보세요(특정 프롬프트가 프로바이더의 콘텐츠 필터에 걸리는 경우가 간혹 있습니다).

결과물이 이상할 때

• 일부 페이지에서 캐릭터가 다르게 보임 — 그 페이지들의 프롬프트가 실제로 캐릭터를 멘션하는지({이름}), 그리고 dall-e-3 폴백 중에 생성된 페이지는 아닌지 확인하세요(그렇다면 카드에 안내가 표시됩니다).
• 책 전체에서 스타일이 흔들림 — Sketch 툴바에서 스타일 앵커를 지정하세요(Image Pool에 스타일 이미지가 있어야 합니다).
• 마스크가 배경으로 색이 샘 — 그 페이지를 Masking Editor에서 열고 새는 곳을 플러드 필로 칠하세요. 대개 클릭 두 번이면 해결됩니다.
• 영상 카드에 “Missing: …” 표시 — 그 페이지가 Assets 단계 하나를 건너뛰었습니다. 메시지가 어느 단계인지 알려줍니다.

그래도 안 풀린다면

지원팀에 문의하세요 — 정확한 메시지 텍스트와 어느 단계/탭에 있었는지를 함께 보내주시면, 대부분 바로 짚어드릴 수 있습니다.