저는 imagegen-swarm를 Claude Code 및 Codex 스킬로 게시했습니다. 이 도구에 이미지 작업 목록을 제공하면, Codex, Jimeng, Grok, Gemini, Muse, Lovart의 6개 엔진이 한 번에 작동합니다. 대부분 사용자가 이미 가지고 있는 계정을 사용하므로 별도의 이미지 API 키가 필요하지 않습니다. 만약 하나의 엔진이 할당량(quota)에 도달하면, 다른 엔진들이 작업을 이어받습니다.
저는 보통 먼저 기능을 구축한 후에 그에 대해 이야기하는 편입니다. 다음 네 가지 릴리스는 제가 이미 계획하고 있던 것이 아니었습니다. 이들은 X의 댓글, 제가 이미 실행했던 배치 작업, 그리고 보안 스캐너를 통해 나왔습니다.
사용 방법
설치:
npx skills add https://github.com/Ekko237/imagegen-swarm -a claude-code -a codex
Node.js 18+와 Pillow가 설치된 Python 3, 그리고 최소한 하나의 로그인된 엔진이 필요합니다.
또는 CLI에서 배치 작업을 실행할 수 있습니다:
cat > jobs.json <<'EOF'
[
{"id": "lemon", "prompt": "a lemon slice on a blue background, flat illustration", "aspect": "1:1"},
...
8GB M1 MacBook Pro에서 테스트 실행한 결과, 50개 이미지 배치는 2.3분 만에 생성을 완료했습니다. 이는 순수 생성 시간만을 측정한 것입니다. 스크리닝이나 스타일 수정(redo) 등은 이 시간 계산에 포함되지 않으며, 단일 실행이었기 때문에 실제 수치는 다를 수 있습니다.
X의 독자가 일관된 스타일에 대해 문의함
만약 캐릭터, 브랜드 또는 커버 세트를 생성할 경우, 각 엔진마다 고유한 스타일을 가집니다. 이로 인해 배치가 완료되더라도 전체적인 통일성을 유지하지 못하는 경우가 있습니다.
X의 한 독자가 이 점을 지적했습니다. 저는 PR #25에서 시리즈 모드(series mode)를 v1.3.0으로 배포했습니다.
이 기능을 켜면, 모든 엔진이 동일한 스타일 가이드(style guide)를 받게 됩니다. 스타일 참고 이미지는 엔진에 공간이 있는 곳에 첨부됩니다. 각 이미지 이후에는 로컬 Pillow 점수 계산기가 64×64 팔레트 히스토그램과 4×4 밝기 그리드를 비교합니다. 기본 임계값은 0.72입니다. 이보다 낮은 이미지는 폐기되어 대기열(queue)에 다시 들어가며, 이때 지금까지 가장 일관성을 보인 엔진을 우선적으로 선택하여 최대 두 번까지 재시도합니다.
점수는 얼굴, 캐릭터 또는 로고를 인식하지 못합니다. 저는 단색 테스트 이미지에서만 측정했습니다: 동일한 이미지는 1점을 받고, 보색(complementary color)은 0.2점을 받습니다. 실제 다중 엔진 시리즈에 대한 유지율(keep rate)은 측정하지 않았습니다.
시리즈 모드(Series mode)는 기본적으로 꺼져 있습니다. --series --style "..." --style-ref 플래그를 사용하거나, jobs 파일에서 다음처럼 켜야 합니다:
"series": {"style": "...", "ref": ["style.png"]}
node skills/imagegen-swarm/scripts/batch.mjs --jobs jobs.json --out out/ --series --style "..." --style-ref style.png
제가 자동으로 켜지 않은 이유
사람들이 플래그의 존재를 모른다면, 그것을 놓칠 것입니다. 저는 시리즈 모드가 공유 스타일을 감지하여 스스로 켜지도록 만들 뻔했습니다.
하지만 이미 실행했던 배치(batch)가 생각났습니다. 저는 매일 글꼴 이미지(font images)를 생성하는데, 이 이미지들은 하나의 스타일을 공유하도록 설계되지 않았습니다. 만약 도구가 자체적으로 시리즈 모드를 활성화했다면, 혼합된 세트에 강제로 하나의 룩(look)을 적용하려고 했을 것입니다. 따라서 README에는 '다른 스타일의 50개 글꼴 이미지'를 배치 예시로 사용하여 아무런 경고도 받지 않아야 함을 명시했습니다.
그래서 v1.3.1은 PR #27에서 아무것도 활성화하지 않습니다. 도구가 먼저 묻습니다.
만약 동일한 캐릭터, 브랜드, 마스코트, 커버 세트 또는 시리즈를 언급하거나, 모든 작업이 동일한 스타일 참조(style reference)를 공유하는 경우, 어시스턴트는 '이 배치를 하나의 스타일로 공유해야 할까요? 그렇다면 시리즈 모드를 켤게요.'라고 묻습니다. 사용자가 동의한 후에만 모드를 활성화합니다.
CLI는 더욱 조용합니다. 만약 --series를 전달하지 않았고, jobs 파일에 series 키가 없으며, 최소 네 개 이상의 작업이 있고, 모든 작업이 동일하고 비어있지 않은 참조 목록을 가지고 있다면, 표준 에러(stderr)로 이중 언어의 series_hint 이벤트 하나를 출력합니다. 그게 전부입니다. 기다리지 않으며, 이미지 생성 방식도 변경하지 않습니다.
스캐너가 예산 누수를 발견하다
imagegen-swarm에는 선택적인 유료 최후의 수단이 있습니다: 구독 엔진으로는 처리할 수 없는 작업을 전용으로 처리하는 OpenAI 또는 Gemini API 라인입니다. 이 기능은 설정한 배치별 및 월별 예산을 준수합니다.
제가 1.3.1 버전을 ClawHub에 게시했을 때, ClawScan이라는 보안 스캐너가 유료 이미지 재시도(paid image retries)가 설정된 지출 한도를 초과할 수 있다고 보고했습니다.
이 버그는 실제로 존재했습니다. 시리얼 모드(series mode)에서 유료 이미지가 반환되었다가 폐기될 수 있었는데, 이는 낮은 스타일 점수, 잘못된 종횡비, 또는 폐기된 중복 파일 때문일 수 있었습니다. 기존 코드는 이 예산 예약분을 돌려주었습니다. 다른 유료 시도가 시작되면 실제 지출액이 budget_per_batch나 budget_per_month를 초과할 수 있었습니다.
v1.3.2는 PR #28에서, 파일을 나중에 폐기하더라도 실제로 반환된 모든 유료 이미지에 대한 예약을 유지합니다. 알려진 미청구 실패(uncharged failures)의 경우 여전히 슬롯을 해제합니다. 청구가 불분명한 경우, 즉 시간 초과(timeout)나 요청이 중단된 경우(killed request), 해당 슬롯은 배치(batch)의 나머지 기간 동안 예약 상태를 유지합니다. 재실행 또는 재시도 전에 두 가지 한도 모두 다시 확인됩니다. 만약 다른 유료 이미지가 한도를 초과하고 구독 엔진이 작업을 처리할 수 없다면, stopped_by_budget 메시지와 함께 중단됩니다.
테스트는 hermetic(밀폐형)합니다. 실제 제공업체(real provider)는 호출되지 않았습니다.
스캐너가 느슨한 승인을 발견하다
1.3.2 버전으로 다시 스캔했을 때, 또 다른 문제가 플래그 지정되었습니다. Muse 승인 카드들이 카드에 있는 텍스트 필드 내의 키워드를 일치시켜 수락되고 있었습니다. 이로 인해 '이 이미지를 저장하고 동시에 다른 파일을 변경하거나 명령을 실행하는' 복합 요청(compound request)이 통과할 수 있었습니다.
Muse는 헤드리스 브라우저(headless browser)에 의해 구동되며, 일부 실행에서는 파일 저장이 일어나기 전에
솔직히 말씀드리자면, 저는 실제 Muse 승인 카드(Muse approval card)의 샘플을 확보하지 못했기 때문에, 현재 추출기(extractor)는 해당 요청을 인식하지 못하는 것으로 처리합니다. 합법적인 저장(legitimate saves)을 포함하여 모든 라이브 승인 카드는 거부되며, 그 Muse 작업은 중단됩니다. 이후 배치는 최대 --tries (기본값 3)까지 다른 엔진에서 작업을 재시도할 수 있습니다. 승인 카드가 전혀 표시되지 않는 작업은 이전과 동일하게 실행됩니다.
저는 1.3.3 버전을 실제 Muse 세션에서 테스트하지 않았습니다. 이 테스트는 라이브 브라우저가 아닌, 더미(fixtures)에 대한 정책을 다룹니다. 제가 디코딩할 수 있는 실제 카드를 확보한 후에만 이 부분을 완화할 것입니다. 그때까지는 '실패 시 폐쇄(fail closed)'가 올바른 기본 설정입니다.
배운 점
"도움"을 주기 전에 묻기. 일관성 기능(consistency feature)은 문자 세트에는 유용하지만 혼합 배치(mixed batch)에는 해롭습니다. 많은 작업이나 공유 참조와 같은 동일한 단서만으로는 사용자에게 결정할 충분한 근거가 되지 못합니다.
폐기된 유료 이미지를 무시하는 지출 한도(spending cap)는 진정한 제한이 아닙니다. 만약 생성하고, 선별하고, 재시도한다면, 버리는 이미지들 역시 비용이 발생합니다.
권한 프롬프트(permission prompt)의 형태를 증명할 수 없다면 클릭하지 마세요. 지금 당장은 Muse 자동 승인 기능을 중단하는 것이 잘못된 것을 승인하는 것보다 낫습니다.
그리고 공개적으로 배포하세요(ship in public). X에 달린 댓글, 혼합 스타일 배치, 그리고 스캐너 각각이 제가 목록에 넣지 않았던 허점을 발견했습니다.
레포지토리(repo)는 여기에 있습니다: https://github.com/Ekko237/imagegen-swarm. 사용해 보신다면, 어떤 부분이 고장 났는지 또는 무엇을 만들었는지 알려주세요.