문서·데이터
Blender로 카메라와 동선을 먼저 정하고 Seedance에 참조 영상으로 전달하는 사례 모음이다. 39개 사례의 JSON, 영어와 10개 번역 README, 미디어·감사 기록과 Python 도구가 함께 있다. 초기 문서 생성기와 현재 주간 갱신 절차의 역할을 구분해서 읽는 것이 핵심이다.
Evolink-AI의 이 저장소는 영상 생성 엔진이 아니라 Blender·Seedance 사용 사례 39건을 정리한 문서와 데이터다. 원 게시물, 작성자, 날짜, 근거 유형과 실무적 교훈을 함께 제공한다. 사례 번호는 병합 이력 때문에 연속적이지 않으며 마지막 번호 42가 사례 수를 뜻하지 않는다.
2026-10-29에 확인한 커밋 7a9d91a84097cd8410bf684d316c5156a5ee1f55은 공개 접근 가능하다. 이전 문서의 삭제·비공개 안내는 제거했다.
텍스트만으로 운 좋게 원하는 운경을 얻는 대신, 저해상도 3D 프리비주얼라이제이션으로 이동·구도·타이밍을 먼저 지정하는 접근을 모았다. 카메라 제어 8건, 인물·액션 7건, 에이전트·MCP 5건, 참조·프롬프트 8건, 제작 파이프라인 5건, 한계·문제 해결 6건으로 나뉜다.
이는 JSON의 분류 수치이며 독립 성능 평가 결과가 아니다. 원 게시자의 성공 사례와 실패 관찰이 섞여 있으므로 자신의 장면에서 다시 비교해야 한다. Quick Start는 운영사 EvoLink의 키 발급과 외부 패키지 설치를 안내한다. 자료를 읽는 데 키는 필요 없다.
| 층 | 현재 확인되는 구성 | 역할 |
|---|---|---|
| 문서 | README.md와 10개 번역 | 설치 경로 안내·6개 분류·39개 사례·원문 링크 |
| 데이터 | blender-seedance-usecase-curated.json | metadata와 items, 사례별 출처·교훈·미디어 경로 |
| 외부 제작 도구 | Blender·Blender MCP·Seedance·선택적 Topaz | 3D 참조 제작·에이전트 제어·영상 생성·업스케일 |
| 유지보수 코드 | Python 검증·감사 도구, 초기 생성기 | 사례·번역·링크·미디어의 일관성 검사와 문서 관리 |
이 저장소의 Python은 영상 모델을 실행하는 서버가 아니라 자료 관리 도구다. generate_repo.py는 Pillow를 쓰는 초기 골격 생성기이며, 유지보수 문서는 현재 번역을 덮어쓸 수 있어 주간 업데이트에서 실행하지 말라고 명시한다.
주간 계약은 고정된 수집 시각까지 7일간의 후보에서 검증 가능한 사례를 최대 10개 골라 영어·데이터를 먼저 고치고 번역을 갱신하는 방식이다. 개별 번역을 초기 생성기로 일괄 덮어쓰는 파이프라인이 아니다. 기존 사례 번호는 보존하므로 배열 길이는 번호의 최댓값과 다를 수 있다.
verify_repo.py는 JSON 항목 수를 기준으로 11개 README의 앵커·제목·사례 집합을 대조하고, 출처 메타데이터·필수 파일·공개 미디어 URL과 지정된 로컬 파일의 존재도 확인한다. 이는 문서 무결성 검사이며 영상 생성 품질을 평가하는 테스트는 아니다.
제작 흐름에서는 참조 영상이 공간과 시간, 시작 프레임이 외관을 맡는다. 사례 41은 정교한 3D 손·소품이 결과에 CG 외관으로 남을 수 있어 단순한 대리 블록이 유리했던 관찰이다. 사례 38의 다중 카메라 컷도 정확한 재현을 보장하는 기능 사양이 아니라 비교 실험으로 읽는다.
공개 README의 미리보기는 R2를 사용하고 과거 로컬 미디어도 트리에 남아 있다. 큐레이션 JSON의 generated_at은 2026-07-20이다. 유지보수 문서의 현황 수치 32건과 과거 검증 보고의 25건은 현재 JSON·README의 39건과 다르므로, 날짜가 다른 감사 산출물을 현재 총계로 인용하지 않는다.
자료 검증: 요약 문구보다 원 게시물의 실험 조건을 먼저 읽는다. Demo·Tutorial·Integration·Limit 같은 evidence_type과 작성자의 설명을 대조해 검증 수준을 구분한다.
데이터 모델링: 사례 식별자와 배열 길이를 구분하고, 분류 합계·URL 중복·필수 출처를 검사한다. 검증기는 앵커의 개수뿐 아니라 순서·중복과 JSON의 사례 집합도 대조한다. 번역문을 고칠 때도 식별자는 그대로 유지하는 설계를 배울 수 있다.
참조 조건화: 카메라·인물 동작·외관을 한 번에 바꾸지 않고 같은 장면에서 하나씩 비교한다. 사례 31의 중간 프레임 제거, 사례 41의 단순 블록은 저자의 문제 해결 관찰이며 모든 영상 모델에 적용되는 보편 법칙은 아니다.
| 목적 | 필요한 것 |
|---|---|
| 문서·JSON 읽기 | 브라우저 또는 텍스트 편집기. GPU·API 키 불필요 |
| 문서 검증 | Python 3와 전체 소스·미디어 체크아웃. verify_repo.py는 표준 라이브러리를 사용 |
| 3D 참조 제작 | Blender와 장면 규모에 맞는 시스템. 수치화된 최소 GPU·RAM은 이 저장소에 없음 |
| 외부 생성 흐름 | MCP 연결·외부 스킬·EvoLink 키와 이용 조건 확인. 실제 생성·업스케일 비용은 별도 |
Quick Start의 npm 패키지는 별도 프로젝트다. 이 저장소에는 그 패키지의 잠금 파일이 없어 설치 버전이나 호환성을 여기서 검증할 수 없다. LICENSE는 큐레이션 자료에 CC BY 4.0을 명시하고, 원 게시물·이미지·영상·상표는 각 권리자에게 남는다고 구분한다. 외부 콘텐츠를 일괄 재사용할 수 있다는 의미는 아니다.
import json
from collections import Counter
from pathlib import Path
data = json.loads(Path("blender-seedance-usecase-curated.json").read_text())
items = data["items"]
assert len(items) == data["metadata"]["selected_count"]
counts = dict(Counter(item["category"] for item in items))
assert counts == data["metadata"]["category_counts"]
print(len(items), counts)
위 코드는 이 글의 간단한 로컬 데이터 확인 예시다. 저장소 자체의 더 넓은 검증은 전체 체크아웃에서 python3 scripts/verify_repo.py로 수행한다. 초기 생성기는 현재 번역을 보존하는 주간 갱신 명령이 아니므로 실습에서도 무심코 실행하지 않는다.
| 주차 | 목표 | 산출물 |
|---|---|---|
| 1주 | 출처·분류·데이터 스키마 읽기 | 39개 항목의 출처·중복·분류 검사표 |
| 2주 | Blender 카메라와 블록아웃 | 이동·회전·타이밍을 분리한 참조 영상 |
| 3주 | 참조 영상과 시작 프레임의 역할 비교 | 통제한 입력과 실패 조건을 담은 실험 노트 |
| 4주 | verify_repo.py와 주간 갱신 계약 분석 | 사례 식별자·번역·미디어 검증을 연결한 유지보수 체크리스트 |
원본을 읽어 분석했으며 외부 패키지 설치·모델 호출·영상 생성은 실행하지 않았다.