samyost1/3dicon

One prompt in, a looping animated 3D icon out — with real transparency. A Claude Code skill.

무엇인가요

/3dicon은 자연어 프롬프트를 루프되는 애니메이션 3D 아이콘(실제 알파 투명도를 갖춘 WebP로 내보냄)으로 변환하는 작고 자체 호스팅 가능한 도구입니다. Claude 스타일의 플러그인 또는 명령줄에서 호출할 수 있도록 설계되었으며, UI에 바로 드롭할 수 있는 자산을 생성합니다.

작동 방식

프롬프트 → 정지 이미지 – 사용자의 텍스트는 OpenRouter를 통해 이미지 생성 모델(GPT Image라고 함)에 전송되어 3D 스타일의 단일 이미지를 생성합니다.
첫 번째 및 마지막 프레임 – 동일한 정지 이미지가 짧은 비디오 클립의 첫 번째 및 마지막 프레임으로 사용됩니다.
비디오 모델 – 비디오 생성 모델(Seedance라고 명명됨)이 중간 프레임을 생성하여 움직임이 원래 정지 이미지로 돌아오도록 보장합니다.
매트팅 – 각 프레임은 알려진 색상의 배경을 제거하는 매트팅 모델을 통과시켜 원래 색상 정확하게 재구성하고 깔끔한 부드러운 에지를 가능하게 합니다.
내보내기 – 처리된 프레임이 진짜 투명도를 유지하는 애니메이션 WebP로 조합됩니다.

핵심 기술은 정지 이미지를 시작과 끝에 모두 재사용하여 비디오 모델이 시ーム리스 루프를 생성하도록 강제하는 것입니다.

설치 단계

# 플러그인을 Claude/어시스턴트 환경에 추가
/plugin marketplace add samyost1/3dicon
/plugin install 3dicon

# 로컬에 기술을 클론 (표시된 경로는 Claude가 기술을 저장하는 위치입니다)
cd ~/.claude/skills/3dicon
pip install -r requirements.txt   # Python 종속성 설치
cp .env.example .env               # 환경 템플릿 복사

.env 파일을 편집하고 OpenRouter API 키를 삽입합니다:

OPENROUTER_API_KEY=sk-or-…

시스템 PATH에 ffmpeg가 사용 가능하도록 확인하세요. 첫 실행 시 약 180MB의 매트팅 모델도 다운로드됩니다.

도구 사용법

Claude 채팅(또는 플러그인에 명령을 전달하는 모든 인터페이스)에서 일반적인 언어로 요청하면 됩니다. 예를 들어:

make an animated 3d fire icon using /3dicon

워크플로우는 상호작용식입니다:

시스템이 정지 이미지를 생성하고 표시합니다.
정지 이미지를 확인합니다(결과가 마음에 들면 움직임에 대한 요금이 발생합니다).
그런 다음 애니메이션 움직임을 제안하며, 다시 확인합니다.
최종 애니메이션 WebP가 반환됩니다.

라이선스 및 소유권

코드는 MIT 라이선스 하에 배포됩니다. 생성한 아이콘은 추가 제약 없이 귀하의 소유입니다.

위 모든 세부 정보는 리포지토리의 README에서 직접 가져왔습니다.