buzz77/buzz-image

buzz-image은(는) 무엇을 하나요?

이 Claude Code가 연결된 BUZZ 게이트웨이를 통해 GPT Image로 이미지를 생성하고 편집합니다. Claude Code 자체의 BUZZ 키를 재사용하므로 별도의 설치나 설정이 필요하지 않습니다. 항상 번들된 스크립트를 사용하세요. 직접 이미지 API 호출을 작성하거나 API 키를 찾거나 출력하지 마세요.

사용자가 사용하는 언어로 답변하세요.

스크립트 실행

항상 timeout: 600000을 전달하세요(이미지는 일반적으로 30~90초 소요, 크거나 고품질 이미지는 더 오래 걸림).

Bash 도구가 있다면 사용하세요. 다음 명령어 형식은 사전 승인되어 있습니다:

bash ${CLAUDE_SKILL_DIR}/scripts/gen.sh -p "프롬프트" -o 경로 [옵션]

그렇지 않으면 PowerShell 도구를 사용하세요(Windows에서 일반적). 스크립트 경로를 첫 단어로 직접 호출하세요. & 없이, 경로 주위에 따옴표 없이, 중첩된 powershell 프로세스 없이, 앞이나 뒤에 아무것도 연결하지 않고 사전 승인된 형식과 일치시켜야 합니다:

${CLAUDE_SKILL_DIR}/scripts/gen.ps1 -Prompt "프롬프트" -Out 경로 [-Size ..] [-Quality ..] [-Background ..] [-Format ..] [-N ..] [-Ref a.png,b.png] [-Mask m.png] [-Model ..]

Claude Code가 여전히 사용자에게 명령어 승인을 요청한다면 괜찮습니다. 승인을 기다리세요. 우회 방법을 찾지 마세요.

옵션	값
-p	이미지 설명 (필수). 사용자 요청에서 직접 작성하세요.
-o	출력 경로. 용도에 맞는 경로를 선택하세요(예: public/favicon.png, assets/og.png). 그렇지 않으면 generated/ 아래에 저장하세요. 기존 파일은 덮어쓰지 않습니다(-2, -3...이 추가됨).
-s	정확한 WxH(모든 크기, 예: 32x32, 1200x630) 또는 square / landscape / portrait / wide / tall / 2k / 4k. 모델이 직접 생성할 수 없는 크기는 가깝게 생성한 후 로컬에서 크롭/스케일하여 정확한 크기로 만듭니다. 생략하면 모델이 결정하게 합니다.
-b	transparent(컷아웃/스티커/아이콘의 배경 제거, png 또는 webp 전용), opaque, auto.
-q	low / medium / high / xhigh / max. 사용자가 요청하거나 에셋에 세부 묘사가 필요한 경우가 아니면 생략하세요.
-f	png(기본값) / jpeg / webp.
-n	이미지 수, 기본값 1.
-r	소스/참조 이미지, 여러 개를 위해 반복 가능. -r이 하나라도 있으면 편집 모드로 전환됩니다.
--mask	로컬 편집을 위한 PNG 마스크(투명 영역 = 다시 그리기), -r 필요.
-m	모델. 생략하면 사용자 키에 사용 가능한 최상의 모델을 자동 선택합니다.
--models	이미지를 생성하지 않고 이 키로 사용 가능한 이미지 모델을 나열합니다.

스크립트는 JSON 한 줄을 출력합니다. 성공: {"ok":true,"model":..,"files":[..],"size":..,"generated_size":..,"resized":..,"seconds":..}. 실패: {"ok":false,"code":..,"message":..}.

워크플로우

1. 요청 이해: 이미지의 용도, 저장 위치, 렌더링할 정확한 텍스트, 크기, 투명도. 필수 정보가 누락된 경우 한 가지 짧은 질문을 하세요. 그렇지 않으면 진행하세요.
2. 실제 참조 사용, 브랜드 에셋 절대 임의 생성 금지.
   • 사용자가 이미지를 지정하거나 첨부한 경우("이 스크린샷처럼", "우리 로고 사용", "이 스타일과 일치하게"), 모든 이미지를 -r로 전달하세요.
   • 이미지에 사용자의 브랜드/제품(로고, OG/소셜 카드, 배너, 파비콘, 앱 아이콘, 제품 이름이 포함된 모든 것)이 표시되거나 일치해야 하는 경우, 먼저 프로젝트의 기존 에셋을 찾으세요. 예: logo*, icon*, favicon*, brand*, og*라는 이름의 파일을 public/, assets/, static/, src/assets/, images/ 디렉토리와 HTML/manifest에서 참조된 로고에서 찾고, 가장 일치하는 파일을 -r로 전달하고 프롬프트에서 사용 방법을 설명하세요("참조 이미지의 로고를 있는 그대로 정확히 사용하고 다시 그리지 마십시오").
   • 적합한 것을 찾을 수 없으면, 사용자에게 로고/참조를 요청하고 임의로 만들지 마세요. 사용자가 명시적으로 요청하는 경우에만 새 로고를 디자인하세요.
   • 참조 이미지는 png, jpeg 또는 webp여야 합니다. 로고가 SVG로만 존재하는 경우 사용자에게 알리고 PNG 내보내기를 요청하세요(또는 동의하는 경우에만 없이 진행).
3. 프롬프트 작성: 사용자의 설명(및 프로젝트 컨텍스트, 예: 브랜드 색상)을 기반으로 작성하세요. 사용자의 의도와 정확한 텍스트를 유지하고, 요청하지 않은 것은 추가하지 마세요. 사용자가 요청하지 않는 한, 모델에 타사 로고, 상표 또는 브랜드 마크를 포함하지 말라고 지시하세요(모델은 기술 이미지를 유명 회사 로고로 장식하는 경향이 있음).
4. 수 세기: 사용자가 더 많이 요청하지 않는 한 1개의 이미지를 생성하세요. 한 번에 4개 이상 생성하기 전에 사용자에게 확인을 요청하세요.
5. 모델: 사용자가 지정하지 않으면 스크립트가 선택하게 하세요. 사용된 모델을 사용자에게 알리세요. 편집, 참조가 많은 작업 또는 밀집/정밀 텍스트의 경우 gpt-image-2.5-sunburst를 추천하세요(사용 가능한 경우). 사용자가 요청할 때마다 모델을 전환하세요.
6. 스크립트 실행.
7. 결과 확인: 각 출력 이미지를 한 번씩 읽으세요. 사용자에게 파일 경로, 모델, 최종 크기, 사용된 참조 이미지, 요청과 일치하지 않는 사항(철자 오류, 로고 변경, 잘못된 레이아웃, 배경 투명하지 않음 등)을 구체적인 제안과 함께 보고하세요. 스스로 재생성하지 마세요 — 사용자가 결정합니다.
8. 보기: 사용자가 보고 싶어하면 시스템 뷰어로 엽니다(macOS는 open, Windows는 start "" <file>, Linux는 xdg-open).
9. 변경 사항: 사용자가 요청하는 대로 적용하세요. 조정된 프롬프트로 재생성하거나 이전 결과를 -r <이전 파일>로 편집하세요. 편집할 때는 소스 이미지의 크기를 유지하기 위해 -s를 전달하세요(사용자가 다른 크기를 원하지 않는 한). 원본을 덮어쓰지 말고 새 파일을 작성하세요.
10. 사용자가 요청하지 않는 한 생성된 이미지를 git add하지 마세요.

오류(JSON의 code)

code	사용자에게 알릴 내용 / 수행할 작업
not_buzz	이 Claude Code가 BUZZ에 연결되어 있지 않아 buzz-image를 실행할 수 없습니다. 중지하세요.
no_key	Claude Code 구성에 API 키가 없습니다. 중지하세요.
no_image_model	키의 그룹에 GPT Image 모델이 없습니다. BUZZ 콘솔(API 키 페이지)에서 gpt-image 모델을 포함하는 그룹으로 키 그룹을 변경하세요. 중지하세요.
model_unavailable	해당 모델을 키에서 사용할 수 없습니다. available_models를 표시하고 사용자가 선택하게 하세요.
insufficient_balance	잔액이 너무 낮습니다. BUZZ 콘솔에서 충전하세요. 중지하세요.
content_policy	메시지를 전달하고 사용자가 어떻게 다시 표현할지 결정하게 하세요. 스스로 다시 표현하고 재시도하지 마세요.
timeout	시간이 초과되었음을 사용자에게 알리세요. 자동으로 재시도하지 마세요(이미지가 이미 청구되었을 수 있음). 재시도 제안을 하세요.
http_error / bad_args	메시지를 보고하세요. 자신의 인수 실수를 수정하세요. 반복하지 마세요.

오류 후 스스로 모델을 전환하거나 계속 재시도하지 마세요.