소개
Meshy N1은 3D 물체 위에서 직접 색을 생성하는 텍스처 모델입니다. Retexture에 기존 메시와 참조 이미지를 전달하면 형태와 면 수를 유지하면서 텍스처를 바꾼 GLB를 반환합니다. 물체 사진으로 원래 외관을 입히거나 스타일 이미지로 다른 배색을 시도할 수 있습니다. 여러 시점을 투영하는 방식에서 생기기 쉬운 이중 윤곽, 색 번짐, 끊어진 무늬를 줄입니다.
핵심 기능 및 하이라이트
흰색 부츠에 가죽 색과 봉제선을 입힙니다
정면 제품 사진을 사용하자 텍스처와 UV가 없던 부츠에 낡은 갈색 가죽, 봉제선, 빨간 끈, 황동색 끈 구멍이 표현됐습니다. 밑창 무늬도 짙은 갈색으로 채워졌습니다. 35초 만에 받은 GLB는 3.5MB였으며 2048픽셀 PNG 텍스처 1장과 기존 삼각형 2,804개를 유지했습니다. 별도의 PBR 맵은 포함하지 않습니다.
배색을 빌려도 부츠 형태는 유지합니다
흰색과 주황색 장난감 우주비행사 이미지를 쓰고 UV 유지를 끄자 흰색 갑피, 회청색 앞코, 남색 끈, 작은 주황색 표시가 생겼습니다. 우주복 패널 같은 무늬도 나타났습니다. 28초가 걸렸으며 GLB는 2.6MB, 삼각형은 그대로 2,804개였습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
mesh_url | 예 | 90MB 이하 GLB, 바이너리 FBX, OBJ 또는 STL 메시를 사용합니다. 직접 링크는 해당 확장자로 끝나야 하며 JSON .gltf는 .glb로 변환합니다. 1자 이상 |
reference_image_urls | 아니요 | 같은 물체의 사진 또는 렌더 이미지 1~4장을 넣고 정면을 첫 번째로 둡니다. 이 필드와 |
reference_image_url | 아니요 | 색, 재질 느낌, 표시를 보여 주는 스타일 이미지 1장을 사용합니다. 정면으로 취급하며 |
keep_original_uv | 아니요 | 기본적으로 켜져 있으며 기존 UV를 유지합니다. 끄면 새로 펼치고, UV가 없는 입력은 어느 설정에서나 새 UV를 만듭니다. 기본값: |
요금
$0.48 / 결과
성공적으로 전달된 결과마다 고정 요금을 부과합니다. 모델 크기, 참조 이미지 수, keep_original_uv 설정에 따라 달라지지 않습니다. 잘못된 형식이나 참조 누락을 포함한 실패 요청에는 요금을 부과하지 않습니다.
활용 사례
소품 하나로 여러 배색을 시험합니다
게임 아이템이나 AR 소품의 메시를 유지하면서 가죽 느낌, 도색 느낌 등 다양한 색과 무늬를 입힐 수 있습니다. 실제 배치할 장면에서 각 버전을 비교하면 색이 어떻게 보이는지 판단하기 편합니다.
흰색 모델의 완성 모습을 살펴봅니다
흰색 모델이나 3D 프린팅용 디지털 모델에 색을 입혀 완성할 배색을 검토합니다. 온라인 상점의 기존 제품 모델에도 여러 색을 시험하고, 공개하기 전에 뒤쪽과 바닥까지 확인하는 데 활용합니다.
프롬프트 가이드 및 실전 팁
기존 모델을 준비합니다
mesh_url에 90MB 이하의 GLB, 바이너리 FBX, OBJ 또는 STL을 업로드하거나 .glb, .fbx, .obj, .stl로 끝나는 직접 링크를 전달합니다. JSON 형식의 .gltf는 먼저 .glb로 내보내야 합니다. Meshy가 제시한 최대치는 면 7,999,999개입니다. 모델이 없다면 Tripo P1, Tripo H3.1 또는 Seed3D 2.0으로 이미지에서 시작 모델을 만들 수 있습니다.
참조 방식 하나를 선택합니다
같은 물체의 사진이나 렌더 이미지 1~4장을 reference_image_urls에 넣고 정면을 첫 번째로 배치합니다. 색, 재질 느낌, 표시를 참고하려면 reference_image_url에 스타일 이미지 1장을 지정하며 정면으로 취급합니다. 두 필드를 모두 넣거나 모두 비우면 접수 단계에서 거절되며 과금하지 않습니다. 텍스트 프롬프트는 입력하지 않습니다.
UV 설정과 결과를 확인합니다
keep_original_uv의 기본값 true는 기존 UV를 유지하고 false는 새로 펼칩니다. UV가 없는 모델은 두 설정 모두 새 UV를 만듭니다. 받은 GLB를 회전해 이음새, 밑면, 색의 위치를 살펴봅니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "meshy/n1/retexture",
"input": {
"mesh_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.







