Meshy 3D — 생성 + 프린팅
Meshy CLI 0.8 (0.8.5 이상)을 사용하여 사용자의 요청을 전달된 자산(요청된 위치의 파일, 미리보기가 있을 경우 검사된 미리보기, 프린팅의 경우 의도된 크기, 분석/수리 결과 및 요청 시 슬라이서 전달)으로 변환합니다. 로그인 또는 작업 제출만으로는 완료가 아닙니다. 가장 짧은 적합한 파이프라인을 선택하고 후속 작업에는 기존 자산을 재사용하세요.
보안 선언
실행 파일: Meshy CLI — meshy, 또는 고정된 임시 패키지 npm exec --yes [email protected] -- meshy — 그리고 이를 설치하기 위한 npm, 런타임 확인을 위한 node --version. Python, curl, 번들 스크립트는 없습니다.
자격 증명: CLI 자체의 브라우저 로그인(OAuth 장치 흐름)은 세션을 ~/.config/meshy/credentials.v2.json (모드 0600)에 저장 및 갱신하며, OS가 관리하는 키로 암호화됩니다. 기존의 MESHY_API_KEY 또는 명시적인 --api-key-file이 있으면 우선 적용됩니다. 이 스킬은 토큰, 장치 코드 또는 키를 절대 읽거나, 출력하거나 복사하지 않으며, 채팅에서 요청하지도 않습니다. MESHY_API_KEY는 선택 사항입니다.
네트워크: Meshy API (api.meshy.ai) 및 해당 로그인 페이지 (www.meshy.ai), 또는 중국 사이트의 경우 api.meshy.cn 및 meshy.cn; 자격 증명 없이 다운로드 중인 자산의 미디어 호스트 또는 확인 중인 입력 URL; CLI가 설치되거나 임시 패키지로 실행될 때 npm 레지스트리.
파일: 작업당 하나의 워크스페이스(사용자가 지정한 디렉토리 또는 ./meshy_output) 내에서만 쓰기를 수행하며, CLI는 심볼릭 링크를 포함한 이스케이프 경로를 거부합니다. 사용자가 요청하지 않는 한 기존 파일을 덮어쓰지 않습니다. 사용자가 지정한 입력 파일과 워크스페이스 내 자신의 출력(미리보기, 사이드카)을 읽습니다. 슬라이서 전달은 이미 설치된 슬라이서 응용 프로그램을 실행합니다.
이 머신을 떠나는 데이터: Meshy로 전송되는 프롬프트, 입력 이미지/모델 및 작업 요청.
이 요청에 필요한 것 읽기
| 필요 | 참조 |
|---|---|
| CLI 실행기, 로그인 또는 출력 위치 | 설정 |
| 디지털 자산: 생성 및 프로젝트를 위해 쌍을 이룰 모델, 텍스처링, 리메싱, 변환, 이미지 | 파이프라인 |
| 리깅, 애니메이션 또는 생성된 모션 | 애니메이션 |
| 물리적 프린트: 로컬 준비, 프린트 생성, 분석/수리, 슬라이서 | 프린팅 레시피 |
| Creative Lab 제품(피규어, 램프, 열쇠고리, 자석, 키캡, 피젯) | Creative Lab |
| 비용, 대기, 미리보기, 전달 또는 이전 모델 찾기 | 전달 |
| 실패 또는 불확실한 작업 | 문제 해결 |
필요할 때 관련 섹션을 읽으세요; 레시피는 전체 실행 단계가 아닌 적용 가능한 예시입니다. 텍스처가 없는 모델은 텍스처링을 건너뜁니다. 기존 GLB는 변환이 필요 없습니다. 매개변수가 불확실할 때는 명령어 --help를 사용하세요.
디지털 자산 또는 물리적 프린트
프린트, 슬라이서, 3MF, STL, Bambu/Orca/Prusa/Cura, 다색, 책상 장난감 또는 물리적 피규어 등 프린트하려는 모든 것은 첫 번째 명령어부터 프린팅 레시피를 따르므로 생성 매개변수가 프린트에 맞춰집니다. 그 외의 모든 것은 파이프라인을 따릅니다.
| 프린트 요청 | 경로 |
|---|---|
| 기존 OBJ 크기 조정, 방향 지정 또는 바닥에 놓기 | 로컬 mesh prepare-print; 로그인 또는 잔액 불필요 |
| 기존 STL 또는 3MF 열기 | 로컬 slicer detect 및 slicer open; 로그인 또는 잔액 불필요 |
| 사진, 스케치 또는 텍스트로 만든 흰색 모델 | 사진: image-to-3d. 그렇지 않으면 먼저 참조 이미지를 권장(깊이 또는 측면이 중요한 경우 여러 뷰), 더 빠른 대안으로 text-to-3d; 텍스처 없는 지오메트리; 필요에 따라 분석/수리; 파일 준비 |
| 다색 모델 | 지오메트리 생성/재사용; 필요에 따라 분석/수리; 텍스처링; 다색 프린트 |
| 별도 부품으로 프린트(빌드 플레이트, 부품별 색상, 지지대 최소화) | 지오메트리 생성/재사용; 자동 분할; 부품 슬라이싱 |
| 기존 모델 확인 또는 수리(구멍, 얇은 벽), 모든 포맷 | 작업 ID 또는 --model-url로 무료 printability 분석; 필요한 경우에만 수리 |
| 기존 STL, 3MF 또는 GLB 크기 조정 | 슬라이서에서 크기 조정; 로컬에서 크기 조정되는 것은 OBJ만 해당 |
| Creative Lab 피규어(사진으로 만든 스타일화된 수집품), 비닐 피규어, 벽돌 피규어, 램프, 열쇠고리, 냉장고 자석, 키캡 또는 픽셀 피젯 보드 | 프로토타입 → 검토 → 제작 → 제품 아티팩트 선택 |
| Creative Lab 접이식 피젯 | 사진에서 한 번 생성 → STL |
색상 경로는 다릅니다: 다색은 다중 재료 프린터를 위해 하나의 객체 표면에 칠합니다; 분할은 객체를 여러 부품(각각 하나의 필라멘트)으로 자르고 텍스처를 제거합니다(분할은 수리 전에 수행하며, 두 단계는 연결되지 않습니다); 픽셀 피젯 보드는 독자적인 제품입니다.
피규어 자체가 Creative Lab을 의미하지는 않습니다. 크기, 색상 또는 스타일에 대해 묻는 것은 누락된 선택이 결과를 실질적으로 변경할 때만 하세요.
OpenClaw에서 첫 사용 및 로그인
첫 번째 명령어 이전에 meshy --version을 실행하세요; 묻지 마세요. meshy가 없거나 0.8.5보다 오래된 경우, npm install -g [email protected]로 최신 0.8.x를 설치하고 한 줄로 알리세요; 설정은 거부된 설치 및 0.9 이상의 CLI를 다룹니다. 로컬 전용 프린트 작업은 여기서 멈춥니다. 그 외의 모든 것은 확인된 auth status 세션을 재사용합니다. 세션이 없을 때만 로그인합니다:
exec와 짧은yieldMs(약 3000) 및timeoutSeconds: 900을 사용하여meshy auth login --device --format json --no-update-check를 시작합니다(중국 본토 사용자의 경우--region cn추가: 글로벌 사이트와 동일한 계정 및 크레딧). 이렇게 하면 백그라운드에서 계속 실행되고sessionId를 반환합니다.- CLI는 몇 초 내에 stderr에
Enter code … at https://www.meshy.ai/device를 출력합니다. 첫 번째 출력에 npm 알림만 있는 경우, 동일한sessionId로process poll을 수행합니다. 사용자에게 URL을 링크로, 코드를 그대로 보내고, 무엇을 해야 하는지 알립니다: 열기, Meshy에 로그인(요청 시), 코드 입력, 승인. 채팅으로 다시 보낼 것은 없습니다. - 두 번째 로그인을 시작하거나, 세션을 종료하거나, 직접 HTTP를 폴링하지 마십시오. CLI는 승인을 기다립니다. 종료되면 OpenClaw가 이 세션을 깨웁니다.
process poll로 결과를 수집합니다(깨어나지 않는 하위 에이전트는 양보하기 전에 폴링합니다). 그런 다음auth status를 확인하고 이미 주어진 입력, 경로 및 예산으로 원래 요청을 계속합니다.
백그라운드 세션은 & 또는 nohup으로 분리해서는 안 됩니다. 만료되거나 거부된 코드는 동일한 로그인을 다시 실행하는 것을 의미합니다; 유료 작업을 다시 실행하는 정당한 이유가 아닙니다. 긴 wait 명령어도 동일한 방식으로 작동합니다: exec가 백그라운드에서 실행되도록 하고 완료 깨우기에서 재개하며, 재제출하거나 sleep 루프를 돌지 않습니다.
CLI만이 해당 설정 디렉토리에 접근합니다. 샌드박스에 의해 차단된 로그인은 설정 섹션 3을 따릅니다.
실행 경계
- API, 업로드, 다운로드 및 메시 작업은 CLI를 통해 실행합니다. 로컬 입력은 50MiB 제한이 있으며, 로컬 모델은 GLB 또는 glTF여야 합니다(리깅, UV 언랩 및 다색: GLB); 그 외의 경우 지원되는 URL 입력 경로를 사용합니다.
- 모든 명령어는
--format json --no-update-check를 사용하고 하나의meshy.cli/v1인벨로프를 출력하며, 인증을 포함합니다. 사용자의 출력 경로에서WORKSPACE를 확인하고 모든 쓰기에 전달합니다. - 첫 번째 유료 생성 전에 모델의 용도를 알아야 합니다: 게임 자산, 리깅할 캐릭터, 렌더링, 3D 프린트. 사용자가 말하지 않은 경우 한 번 묻습니다. 답변에 따라 경로와 모델이 결정됩니다(파이프라인). 게임 자산 또는 면 수 예산은 스마트 토폴로지를 의미하며, 표준 모델을 리메싱한 것이 아닙니다.
create --async로 한 번 제출하고 소유 리소스 및 작업 ID를 유지한 다음 해당 작업을wait합니다. 시간 초과 및 알 수 없는 제출은 문제 해결을 따릅니다. 다른 유료 생성을 승인하지 않습니다.- 사용 가능한 사진이 없으면 먼저 참조 이미지를 만들고 그로부터 모델을 구축하는 것을 권장합니다. text-to-3d는 더 빠른 대안입니다(파이프라인, 이미지로 시작; 프린트: 프린팅 레시피, 섹션 1).
- 승인된 범위와 예산 내에서 작업합니다. 추가 유료 단계 또는 재실행을 비용 지출 전에 제안합니다. 로컬 준비 및 출력 가능성 분석은 무료입니다. 전달은 견적을 다룹니다.
- 수리는 지오메트리를 변경하고 텍스처를 삭제합니다. 수리된 지오메트리를 다운스트림에 사용하고 다색 출력 전에 다시 텍스처링합니다. Y-up OBJ를 한 번 새 파일로 준비합니다. 해당 변환을 STL, 3MF 또는 릴리프 제품 출력에 적용하지 마십시오.
전달
필요한 자산만 다운로드합니다. 사용 가능한 렌더링 미리보기를 이미지로 사용자에게 보냅니다. 미리보기가 없으면 명시하고, 렌더링된 PNG는 3D 뷰어가 아닙니다. 파일 경로, 후속 작업을 위한 작업 ID 및 실제 청구 금액을 보고합니다. 프린트의 경우 치수 및 분석/수리 상태도 보고합니다. 요청된 경우에만 감지된 슬라이서를 실행하고, launch_requested가 모델이 가져와졌음을 증명하지는 않는다는 점을 언급합니다. 지지대 및 벽 두께와 같은 관련 남은 확인 사항을 테스트되지 않은 모델이 인쇄 가능하다고 보장하지 않고 언급합니다.