Community이미지github.com

tripo3d-blender

이미지 스킬. Tripo3D로 3D 모델을 생성하고 Blender에서 마무리합니다. Tripo3D가 프롬프트나 사진으로 기본 메시를 생성하면, 모든 세부 조정(크기, 방향, 피벗, 정리, 조각 수정, 재도색, 텍스처 크기, LOD, GLB 내보내기)은 Blender(헤드리스 또는 라이브)에서 이루어집니다. 텍스트나 이미지로 3D 모델, 조각상, 소품, 건축물, 바위, 캐릭터 또는 게임 에셋을 생성하라는 요청이 있을 때 사용합니다.

tripo3d-blender란 무엇인가요?

이 스킬은 Tripo3D에서 기본 메시를 생성하고 Blender에서 정교하게 마무리하는 3D 모델 생성 파이프라인을 제공합니다. Tripo3D는 이미지나 텍스트 프롬프트로 약 1분 만에 텍스처가 적용된 메시를 생성하지만, 제어가 거칠고 비용이 발생합니다. 반면 Blender는 무료이며 정밀하고 반복 가능한 스크립트 기반 작업을 지원합니다. 따라서 Tripo3D로 기본 메시를 한 번만 생성하고, 모든 후속 수정(크기, 방향, 피벯, 삼각형 수, 텍스처 크기, 색상, 작은 결함 등)은 Blender에서 처리합니다. Tripo3D 재실행은 형태 자체가 잘못된 경우로 제한하여 비용을 절약합니다. `tripo-cli`(공식 CLI 도구)와 Blender 스크립트를 사용하며, `SKILL.md`에 명시된 대로 설정부터 최종 GLB 내보내기까지 전 과정을 안내합니다. macOS에서 `tripo-cli` 0.11.2, Blender 5.3.0, Node 24로 테스트되었습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hiddentao/tripo3d-blender-skill/tree/HEAD/tripo3d-blender

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Tripo3D 모델, Blender에서 마무리하기

Tripo3D는 사진이나 프롬프트를 약 1분 만에 텍스처가 적용된 메시로 변환합니다. 각 실행은 크레딧을 소모하며, 제어가 거칠고, 새 모델 버전은 동일한 요청에 대해 다른 메시를 생성합니다. Blender는 무료이고 정확하며, 스크립트는 매번 동일한 결과를 제공합니다. 따라서 Tripo3D에서 기본 메시를 한 번 가져와 보관하고, 모든 세부 조정은 Blender에서 수행합니다. 형태가 잘못된 경우에만 새 실행 비용을 지불하십시오. 크기, 방향, 울퉁불퉁한 손, 텍스처 색조, 삼각형 예산은 모두 Blender에서 수정 가능합니다.

2026-11-20 기준 macOS에서 tripo-cli 0.11.2, Blender 5.3.0, Node 24로 테스트 완료. tripo --version이 더 최신 버전을 출력한다면, 플래그 관련해서는 이 파일보다 tripo docs --topic commands/make를 신뢰하세요.

참조 파일

이 파일은 하나의 모델을 설정부터 완성된 GLB까지 진행합니다. 작업에 특정 세부 정보가 필요할 때만 참조 파일을 여십시오.

참조언제 열 것인가줄 수
설정설치 또는 로그인, MCP 서버 추가, Linux 작업, 또는 다른 Tripo 경로 고려 시146
사진대상 사진과 일치해야 하는 모델의 입력 사진을 만들고 검토받을 때123
생성모델 또는 매개변수 선택, 여러 사진 사용, Tripo 자체 단계 연결, 또는 크레딧 계산 시146
blender생성된 모델 수정, 라이브 Blender 작업, 또는 이 단계를 프로젝트 빌드에 통합할 때283
오류실패한 명령의 종료 코드 또는 Blender 스크립트 오류를 읽을 때43

이 파일이 실행하는 두 스크립트는 옆에 있는 tools/ 디렉토리에 있습니다. 아래에서 <skill-dir>은 이 SKILL.md가 있는 폴더를 의미합니다.

1. 사람이 먼저 해야 할 일

에이전트는 이를 수행할 수 없습니다. 무엇이든 실행하기 전에 이를 요청하세요.

  1. 유료 Tripo3D API 계정 (https://developers.tripo3d.ai (국제) 또는 https://developers.tripo3d.com (중국 본토)). API 크레딧은 Tripo Studio 크레딧과 별개입니다. 유료는 권리 측면에서 중요합니다: Tripo 약관은 유료 사용자에게 출력물에 대한 권리(게시 및 판매 포함)를 부여하고(섹션 5.2.2), 무료 사용자의 출력물은 Tripo가 보유합니다(섹션 5.2.1).

  2. 시스템 비밀 저장소의 API 키. macOS에서는 사람이 다음을 실행하고 프롬프트에 키를 입력하므로, 키가 채팅을 통과하지 않습니다:

    security add-generic-password -a "$USER" -s tripo3d-api-key -w
    

    키가 없으면 설정의 브라우저 로그인도 작동합니다.

  3. Blender 5.x, blender가 경로에 있어야 합니다. 라이브 제어에는 Allow Online Access가 켜진 Blender Lab MCP 애드온도 필요합니다. blender 참조.

채팅에서 키를 요청하거나 생성하는 파일에 키를 절대 작성하지 마세요. 2절과 같이 비밀 저장소에서 인라인으로 읽으십시오.

2. Tripo3D 설정

머신당 한 번:

node --version                      # 20 이상 필요
npm install -g tripo-cli            # `tripo` 명령어 설치
tripo login --key "$(security find-generic-password -s tripo3d-api-key -w)" \
  2>&1 | sed -E 's/tsk_[A-Za-z0-9_-]+/tsk_<hidden>/g'
tripo doctor                        # 모든 검사 "ok": true

tripo login --key는 두 리전을 모두 시도하고, 키를 수락하는 리전을 유지하여 ~/.tripo/config.json에 모드 0600으로 저장하므로 이후 명령에 키가 필요하지 않습니다. tripo doctor의 잔액 0은 경고이지 실패가 아닙니다.

모든 Tripo 호출에는 Tripo의 공식 도구인 tripo-cli를 사용하세요. 이전 Tripo-Developer/tripo-mcp 서버는 시작 시 충돌하며 더 이상 존재하지 않는 Blender 애드온을 구동합니다. Blender의 Tripo Bridge 애드온은 사람이 Tripo 웹사이트에서 보낸 모델만 받습니다. 설정에 자세한 내용이 있습니다.

3. 기본 모델 생성

입력 선택. 전체 객체의 사진 한 장, 단독으로, 단색 배경에, 정면 또는 3/4 뷰로. 숨겨진 면을 커버하려면 2~4장의 사진; 파일 이름을 front, left, back, right로 지정하세요. 모델은 사진의 형태, 표면 및 색상을 복사하므로 마모, 이끼, 색상이 사진에 포함되어야 합니다. 따옴표로 묶인 프롬프트도 작동하지만 제어력이 떨어집니다.

비용을 지불하기 전에 사진을 검토받으세요. 사진의 결함은 메시에 그대로 나타나며, 새 실행은 크레딧을 다시 소모합니다. 사람이 컨셉 아트나 사진과 같은 대상을 제공하고 모델이 이와 일치하기를 원할 때:

  1. 대상만으로 체크리스트 작성: 각 부분이 보여주는 것, 실패한 부분, 측정 가능한 비율 및 색상;
  2. 각 뷰에 대해 2~8개의 새로운 후보 생성, 먼저 정면, 통과된 정면에서 다른 뷰 생성;
  3. 대상, 체크리스트 및 후보를 별도의 검토자(만들지 않은 다른 에이전트 또는 사람)에게 제공, 이들의 임무는 후보를 탈락시키는 것;
  4. 통과한 사진에 대해서만 Tripo3D 실행, 검토자가 통과시킨 지점을 기록하여 Blender 마무리에 반영.

사진에는 루프, 검토자 브리핑 방법, 사진 탈락 기준 및 측정 방법이 있습니다.

모델 선택. --model 없이 실행하면 기본적으로 P2를 사용하며, 이는 H3.1보다 약 3배 비쌉니다.

모델플래그드라이런 예상 비용사용 용도
H3.1--model tripo-v3.110~50 크레딧; 상세 PBR 맵이 있는 사진은 40정밀한 단단한 물체: 조각상, 소품, 바위
P2 (기본값)--model tripo-p2100~130 크레딧; 단순한 사진은 110깔끔한 로우폴리 토폴로지, 쿼드

드라이런 실행. 드라이런은 아무것도 보내지 않고 소모하지 않습니다:

tripo make ref.png --model tripo-v3.1 --seed 7 \
  -p face_limit=30000 -p pbr=true -p texture_quality=detailed \
  -p texture_version=v3.5-20260815 -p delight=true \
  --name statue -o tripo-out/statue --dry-run --json

valid는 true여야 하고 errors는 비어 있어야 합니다. warnings의 각 항목은 CLI가 제거한 설정이므로 해당 요구 사항이 충족되지 않습니다; 비용을 지불하기 전에 해결하세요. generation_credits_estimate는 생성 자체의 정가입니다.

실제 실행 (--dry-run 없이). 명령은 모델, preview.png 및 task.json이 -o 폴더에 들어올 때까지 차단된 후 JSON 한 줄을 출력합니다. model_file 필드에서 모델 경로를 가져오세요. 파일 이름은 옵션에 따라 변경됩니다(예: pbr_model.glb). 계속하기 전에 preview.png를 확인하세요.

원시 결과를 보관하세요. 다운로드 링크는 약 5분 후에 만료되며, 이후 모델 버전은 동일한 시드에서 다른 메시를 생성하므로 다운로드한 파일이 유일한 복사본입니다:

mkdir -p assets/raw/statue
cp tripo-out/statue/* assets/raw/statue/    # model, task.json, preview.png

해당 폴더를 커밋하거나 프로젝트의 소스 에셋과 함께 보관하세요. 모든 Blender 단계는 이 복사본을 읽고 네트워크를 사용하지 않으므로 재빌드 시 동일한 파일이 생성됩니다.

중단하고 사람에게 물어보세요:

  • 예상 비용이 50 크레딧을 초과하는 모든 실행, 모든 P2 실행, 예상 합계가 150 크레딧을 초과하는 모든 배치;
  • 종료 코드 4(크레딧 부족) 후에는 모든 재시도가 동일하게 실패하므로: 사람에게 tripo topup을 알리고 대기;
  • tripo redo 전, 새로운 시드가 있는 유료 실행이며 드라이런이 없기 때문.

4. Blender에서 마무리

두 스크립트 모두 창 없이 실행되며 네트워크를 사용하지 않습니다.

정면 찾기. Tripo 문서는 +x를 생성된 모델의 전방 축으로 제공합니다. Blender의 정면 뷰는 +y를 따라 보며 -y를 향한 면을 표시하므로 +x를 -y로 돌리려면 --turn -90입니다. 모든 메시가 기본값을 따르는 것은 아니므로 먼저 원시 모델을 렌더링하고 front.png를 확인하세요:

blender --background --factory-startup \
  --python <skill-dir>/tools/preview_model.py -- \
  assets/raw/statue/<model>.glb build/statue-raw --size 640

약 2초 안에 front.png, side.png, top.png를 생성합니다.

마무리:

blender --background --factory-startup \
  --python <skill-dir>/tools/finish_model.py -- \
  assets/raw/statue/<model>.glb build/statue.glb \
  --height 6.5 --name statue --turn -90 --levels 0.4,0.12 --texture 1024

스크립트는 모든 변환을 정점에 굽고, 파트를 하나의 객체로 결합하며 중복 정점을 병합합니다. 모델을 수직 축으로 --turn 도만큼 회전하고, --height 미터로 스케일링하며, 중앙에 배치하고 가장 낮은 점을 지면에 위치시킵니다. 그런 다음 --texture 텍셀보다 긴 텍스처를 축소하고 statue.glb와 함께 삼각형의 40% 및 12%로 축소된 statue-1.glb, statue-2.glb를 작성합니다. 마지막 줄 FINISHED {...}는 크기, 축소된 텍스처, 각 파일의 삼각형 수와 바이트를 제공합니다. --height만 필수입니다. --turn 기본값은 0이며, --levels 또는 --texture 없으면 복사본을 만들지 않고 텍스처를 유지합니다.

완성된 파일을 같은 방식으로 렌더링하고 다시 확인하세요. 방향이 잘못된 경우 --turn을 변경하고 원시 파일에서 다시 마무리하세요. 내보낸 파일을 절대 회전하지 마세요.

새 실행 비용을 지불하기 전에 Blender에서 수정하세요. 크기, 방향, 피벗, 삼각형 수, 텍스처 크기, 색상, 작은 돌기 및 구멍, 융합된 부품은 Blender 작업입니다. 형태 자체가 잘못된 경우에만 Tripo3D로 돌아가세요. blender에 표가 있습니다.

라이브 Blender를 사용하여 시도해 보세요(예: 손 조각 또는 뷰 비교). 실제로 적용되는 모든 변경은 원시 파일에서 모델을 재구축하는 스크립트로 작성되어야 합니다. 수동 편집은 반복하거나 검토할 수 없고, 다음 재생성 시 손실되기 때문입니다. 프로젝트가 이미 Blender 스크립트로 모델을 빌드한다면, 이 스크립트의 출력을 배포하는 대신 해당 빌드에 이 단계를 추가하세요.

관련 스킬