scenario-labs/blender-plugin

Scenario for Blender – Blender 내 AI 기반 콘텐츠 생성

정의 – 3D 저작 환경에서 직접 Scenario의 클라우드 AI 서비스를 호출할 수 있는 Blender 애드온(Python 확장)입니다. 자연어 프롬프트나 참조 자산에서 이미지, 비디오, 3D 메시, PBR 재질, 오디오, 360° 환경, 전체 블록아웃 레이아웃까지 생성하고 결과를 현재 Blender 장면으로 가져올 수 있습니다.

주요 기능

• 이미지 및 비디오 생성 – 텍스트 프롬프트나 참조 이미지를 텍스처, 배경 플레이트 또는 전체 길이 비디오 클립으로 변환합니다.
• 3D 메시 생성 및 편집 – AI에 새 지오메트리 생성 또는 선택한 메시에 편집 적용을 요청하고 편집된 메시를 Blender로 가져옵니다.
• 재질 합성 – 완전한 PBR 텍스처 세트를 생성하고 재질 슬롯에 자동으로 할당합니다.
• 오디오 합성 – 음성, 음악 또는 효과음을 생성하고 비디오 시퀀서에 배치합니다.
• 렌더 지원 생성 – 장면 캡처(정지 또는 비디오)를 시각적 단서로 사용하여 AI가 일치하는 자산을 생성합니다.
• 블록아웃 도구 – 짧은 장면 설명을 제공하면 더 다듬을 수 있는 그레이박스 레이아웃을 받습니다.
• 환경 생성 – HDRI 파노라마 또는 확대된 360° 배경을 생성하고 월드에 적용합니다.
• 스튜디오 뷰 및 플로팅 컴포저 – 뷰포트를 떠나지 않고 위의 "레인"을 실행할 수 있는 UI 패널.
• MCP 에이전트 – 로컬 scenario-blender 서버가 장면을 외부 에이전트(예: Claude Code, Cursor)에 노출하여 장면을 읽고 대신 유료 AI 작업을 요청할 수 있습니다. 서버는 http://127.0.0.1:9876/mcp에서 실행되며 blender --background … --command scenario_blender를 사용하여 헤드리스로도 사용할 수 있습니다.

설치 방법

1. Blender에서 온라인 액세스를 활성화합니다(편집 → 환경설정 → 시스템 → 네트워크).
2. 편집 → 환경설정 → 확장 프로그램 가져오기 → 원격 저장소 추가를 통해 원격 저장소 https://blender.scenario.com/repo/index.json을 추가합니다.
3. 목록에서 "Scenario"를 설치합니다. 애드온은 환경설정 → 애드온에 나타납니다.
4. Scenario API 키/시크릿(Scenario 웹 콘솔에서 얻음)을 애드온의 자격 증명 패널에 붙여넣고 연결을 테스트합니다.
5. 출력 폴더를 선택합니다. 생성된 자산은 해당 폴더에 저장되고 생성 패널에도 표시됩니다.

(GitHub 릴리스 페이지에서 ZIP을 다운로드하여 수동으로 설치할 수도 있지만 해당 복사본은 자동 업데이트되지 않습니다.)

일반적인 워크플로우

1. Scenario 사이드바를 엽니다(뷰포트에서 N).
2. 레인(이미지, 3D, 오디오 등)을 선택하고 프롬프트를 작성하고 참조 파일을 첨부한 다음 비용 추정치를 확인합니다(Scenario는 크리에이티브 유닛을 청구합니다).
3. 생성을 클릭합니다 – 애드온이 요청을 api.cloud.scenario.com에 보내고 결과를 받아 로컬에 저장합니다.
4. 제공된 작업을 사용하여 자산을 가져옵니다(예: 생성된 텍스처 적용, 메시 추가, 오디오를 시퀀서에 배치).
5. 반복하거나 여러 레인을 결합하여 전체 장면을 구축합니다.

제한 사항 및 주의 사항

• 유료 Scenario 계정이 필요합니다. 각 생성마다 크레딧(크리에이티브 유닛)이 소모됩니다.
• 모든 프롬프트, 매개변수 및 참조 파일은 생성 전에 Scenario의 클라우드 서비스로 전송됩니다. 개인정보 보호 세부 사항은 저장소의 PRIVACY.md에 있습니다.
• 애드온은 실험적으로 표시되어 있습니다 – 일부 레인은 특정 Blender 버전에서 사용할 수 없거나 기능이 제한될 수 있습니다.
• 에이전트(MCP)는 옵트인하면 임의의 Python을 실행할 수 있으며 이는 보안 위험입니다. 기본적으로 비활성화되어 있습니다.
• 오프라인 ZIP 설치에는 자동 업데이트가 제공되지 않습니다. 새 기능이나 버그 수정을 받으려면 다시 설치해야 합니다.

라이선스 – 확장 코드는 GPL-3.0-or-later로 릴리스됩니다(Blender 애드온에 필요). 번들된 SDK 휠은 원래 라이선스를 유지합니다. 자세한 내용은 LICENSE, SDK_BUNDLE.md 및 TRADEMARKS.md를 참조하세요.

더 알아보기

• 사용자 가이드: docs/USER_GUIDE.md(각 레인, 비용 미리보기, 출력 처리 포함).
• API 문서: https://docs.scenario.com.
• MCP 프로토콜 참조: docs/MCP.md.
• 지원: 저장소의 지원 페이지를 통해 이슈를 열거나 support@scenario.com으로 이메일을 보내세요(자격 증명을 공개적으로 게시하지 마세요).

---

Scenario for Blender는 생성 AI를 3D 제작 루프에 직접 가져와 아티스트가 Blender를 떠나지 않고도 자산, 환경, 전체 장면을 프로토타입할 수 있게 합니다.