변경 로그
Meshy API 및 플러그인의 최신 기능과 업데이트를 모두 확인하세요.
2026년 6월
Jun 17
- 새로운 API Playground 문서 페이지: 코드를 작성하지 않고 endpoint를 시도해 본 다음, 이에 해당하는 cURL, Python 또는 JavaScript를 복사할 수 있는 대화형 콘솔입니다. Pro, Premium, Ultra, Studio, Enterprise 플랜에서 사용할 수 있습니다.
Jun 15
- 새로운 UV 언래핑 API: 기존 3D 모델에 대한 고품질 UV 레이아웃을 생성합니다 — 텍스처링 전 필요한 사전 단계이거나, 다운스트림 도구를 위해 깔끔하고 겹치지 않는 UV 레이아웃이 필요할 때 사용합니다.
input_task_id(완료된 이미지로 3D, 텍스트로 3D 또는 리메시 작업) 또는model_url(.glb만)를 입력받아 완전히 새로운 UV 좌표가 적용된 "UV 화이트 모델"을 반환합니다. 호출당 5 크레딧이 필요합니다. 최대 40,000개 면의 메시를 지원합니다(더 큰 경우 먼저 리메시를 실행하세요). 쿼드 및 n-gon 메시는 UV 생성 중 삼각분할됩니다.
Jun 12
- 키링, 냉장고 자석, 피규어의 Creative Lab API Build 요금을 호출당 30 크레딧으로 업데이트했습니다(이전에는 20). 램프는 30 크레딧으로 변경되지 않았습니다. 프로토타입 요금은 이미지당 6 크레딧으로 변경되지 않았습니다. 전체 세부 내역은 요금을 참조하세요.
Jun 5
- 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D, 리텍스처, 리메시, 프린팅 가능성 복구 API에 선택 사항인
alpha_thumbnail파라미터가 추가되었습니다.true로 설정하면 작업이 미리보기의 투명 배경(RGBA) 버전을 추가로 렌더링하고 새alpha_thumbnail_url응답 필드로 반환합니다. 기존thumbnail_url은 변경되지 않습니다. 기본값은false입니다.
Jun 1
- 새로운 Creative Lab API: 소스 사진(또는 텍스트 prompt)을 3D 프린트 가능한 소비자 제품으로 변환하는, 제품 범위가 지정된 endpoint 제품군입니다. 출시 시 네 가지 제품 제공 — 키링, 냉장고 자석, 피규어, 및 램프. 각 제품은
input_task_id를 통해 연결되는 2단계prototype→build워크플로를 따르며, 제품별 버전 관리를 통해 제품이 독립적인 버전 라인에서 발전할 수 있도록 제품 범위 URL(/openapi/creative-lab/<product>/v1/...) 아래에서 제공됩니다. 프로토타입: 호출당 6 크레딧. 빌드: 호출당 30 크레딧.
2026년 5월
May 26
- 멀티 이미지로 3D API에
multi_view_thumbnails파라미터를 추가했습니다.true로 설정하면 작업이 네 방향 뷰 썸네일(앞, 오른쪽, 뒤, 왼쪽)을 추가로 렌더링하고 새thumbnail_urls응답 필드에 반환합니다. 기존thumbnail_url필드는 변경되지 않습니다. 작업 지연 시간에 약 3초가 추가됩니다.
May 22
- 리메시 API의 변환 및 크기 조정 기능을 이제 독립 실행형 변환 API 및 크기 조정 API endpoint로 사용할 수 있습니다. 리메시의 지원 중단된 매개변수는 이전 버전과의 호환성을 위해 계속 작동합니다.
May 13
- 이미지로 3D API에
multi_view_thumbnails파라미터를 추가했습니다.true로 설정하면 작업이 네 가지 기본 방향 뷰 썸네일(정면, 오른쪽, 후면, 왼쪽)을 추가로 렌더링하고 새thumbnail_urls응답 필드 아래에 반환합니다. 기존thumbnail_url필드는 변경되지 않습니다. 작업 지연 시간이 약 3초 추가됩니다.
May 12
- 리메시 API에
resize_longest_side파라미터를 추가했습니다. 가장 긴 바운딩 박스 치수가 지정된 미터 단위 값과 같아지도록 모델 크기를 조정합니다.resize_height및auto_size와 함께 사용할 수 없습니다.
May 11
- 텍스트로 3D, 이미지로 3D, 멀티 이미지로 3D endpoint에서
symmetry_mode파라미터를 지원 중단했습니다. 이 파라미터는 더 이상 출력에 영향을 주지 않습니다.
May 7
- 신규 프린팅 가능성 분석 API: 성공한 Meshy 작업 또는 모든 3D 모델 URL을 FDM 3D 프린팅 준비 상태에 대해 분석합니다. 비동기 생성 + 스트림 패턴: POST는 task_id를 반환한 다음, GET / SSE 스트림은 SUCCEEDED가 되면 밀폐성, 부피, 구멍 및 비매니폴드 에지 지표를 반환합니다. 무료이며, 크레딧이 소모되지 않습니다.
- 신규 프린팅 가능성 복구 API: FDM 프린팅 가능성을 위해 3D 모델을 복구합니다. 비매니폴드 에지, 퇴화 면, 구멍 및 기타 topology 문제를 수정합니다. 기존 Meshy
input_task_id또는model_url(.glb,.stl,.obj)을 허용합니다. 출력 형식은 입력과 일치합니다. 작업당 10 크레딧.
2026년 4월
Apr 27
- 모든 API 엔드포인트의 모든 작업 응답에
consumed_credits필드를 추가했습니다. 각 작업에서 소비한 크레딧 수를 표시합니다. 이 필드는PENDING,IN_PROGRESS,SUCCEEDED상태의 작업에 포함됩니다.FAILED작업의 경우0을 반환합니다(실패 시 크레딧은 자동으로 환불됩니다). 엔드포인트별 크레딧 비용은 요금을 참조하세요.
Apr 24
- 다색 프린트 엔드포인트에
model_url파라미터가 추가되었습니다. 이전 Meshy 작업의input_task_id대신 텍스처가 적용된 3D 모델을 직접 제출하세요(URL 또는 Data URI를 통해). 지원 형식:.glb,.fbx.model_url과input_task_id가 모두 제공된 경우,input_task_id가 우선순위를 가집니다.
Apr 21
- 이미지로 3D 및 멀티 이미지로 3D endpoint에
input_task_id파라미터를 추가했습니다.image_url/image_urls를 제공하는 대신 완료된 텍스트로 이미지 또는 이미지로 이미지 작업의 출력을 직접 참조하세요. 둘 다 제공되는 경우input_task_id가 우선순위를 갖습니다.
Apr 20
- 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D Refine, 리텍스처 endpoint에
hd_texture파라미터가 추가되었습니다. 활성화하면 더 높은 디테일을 위해 베이스 컬러 텍스처가 4K(4096×4096) 해상도로 생성됩니다.meshy-6및latest에서만 지원됩니다. 기본값은false입니다. - 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D Refine, 리텍스처의
meshy-6및latest태스크에서enable_pbr이true일 때 반환되는 PBR 번들에는 이제texture_urls아래에emission맵이 포함됩니다. 요청 변경은 필요하지 않습니다.
Apr 14
- 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D 프리뷰, 리메시 endpoint에
decimation_mode파라미터를 추가했습니다. 적응형 감면 폴리곤 수 수준을 설정합니다:1(울트라),2(높음),3(중간), 또는4(낮음).
Apr 12
- API 문서를 재구성했습니다: 종속 필드가 있는 파라미터 그룹화, 인라인 기본값, 필수/지원 중단 배지, 확장 가능한 하위 탐색을 추가하고, 멀티 이미지, 리깅, 애니메이션을 별도 페이지로 분리했습니다.
2026년 3월
Apr 2
- 모든 endpoint(이미지로 3D, 텍스트로 3D, 리메시, 리텍스처)의
target_formats파라미터에3mf형식 지원을 추가했습니다. 참고: 3MF는 옵트인 전용이며 명시적으로 요청해야 합니다. - 새로운 다색 프린트 API: 3D 프린팅을 위해 3D 모델을 다색 3MF 형식으로 변환합니다. 구성 가능한 정밀도의 1~16색 팔레트를 지원합니다. 작업당 10 크레딧.
Mar 20
- Meshy-4 AI 모델을 종료했습니다.
meshy-4를 사용하는 모든 API 요청은 더 이상 지원되지 않습니다.meshy-6또는latest로 마이그레이션해 주세요. - 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D, 리메시 endpoint에
auto_size및origin_at파라미터를 추가했습니다.auto_size가 활성화되면 서비스는 AI 비전을 사용하여 실제 높이를 추정하고 모델의 크기를 자동으로 조정합니다.origin_at은 원점 위치(bottom또는center)를 설정합니다. 리메시 API에서auto_size는resize_height와 함께 사용할 수 없습니다.
Mar 17
- 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D, 리텍스처 endpoint에 선택 사항인
target_formats파라미터가 추가되었습니다. 작업 완료 시간을 줄이려면 생성할 3D 형식을 지정하세요(예:["glb", "fbx"]).
2026년 2월
Feb 28
- 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D 리파인, 리텍스처 API에
remove_lighting파라미터를 추가했습니다. 사용자 지정 조명에서 더 깔끔한 결과를 위해 베이스 컬러 텍스처에서 하이라이트와 그림자를 제거합니다.meshy-6및latest에서만 지원됩니다. 기본값은true입니다. - 이제 리텍스처 및 텍스트로 3D 리파인 API는 완전한 Meshy 6 텍스처링을 위해
ai_model값으로meshy-6을 지원합니다.
Feb 25
- 입력 이미지 최적화를 선택 해제하고 입력의 정확한 모습을 보존하려는 사용자를 위해 이미지로 3D 및 멀티 이미지로 3D API에
image_enhancement파라미터를 추가했습니다.meshy-6및latest에서만 지원됩니다. 기본값은true입니다.
Feb 20
- 더 깔끔한 폴리곤에 최적화된 로우폴리 메시를 생성하기 위해 텍스트로 3D 미리보기 API에
model_type파라미터를 추가했습니다.
2026년 1월
Jan 27
- 일반적인 HTTP 오류 코드(400, 401, 402, 404, 422, 429)와 작업 실패 이유를 포함하여 모든 API 엔드포인트에 대한 자세한 실패 모드 문서를 추가했습니다. 이를 통해 개발자가 API 오류를 더 잘 이해하고 처리할 수 있습니다.
Jan 26
- 멀티 이미지로 3D API는 이제 전체 메시 생성을 위해 Meshy-6을 지원합니다.
ai_model파라미터는 이제meshy-6을 허용하며,latest는 Meshy 6으로 확인됩니다.
Jan 22
- 텍스트로 3D Preview API(Meshy-6)의
art_style을 지원 중단했습니다. 이 파라미터는 Legacy 모델(Meshy-4 / Meshy-5)용으로 설계되었으며 향후 릴리스에서 제거될 예정입니다. ai_model이meshy-4인 경우 텍스트로 3D 및 이미지로 3D API의enable_pbr을 지원 중단했습니다. 이 파라미터는 향후 릴리스에서 제거될 예정입니다.- 텍스트로 3D 및 이미지로 3D API에서 Meshy-6에 대한
should_remesh파라미터의 기본값을 업데이트했습니다. 이제 이 파라미터는 지정하지 않으면meshy-6의 경우 기본값이false이고, 다른 모델의 경우true입니다.
Jan 19
- 텍스트로 3D (프리뷰) 및 이미지로 3D API의
ai_model에 대한latest옵션이 이제 Meshy 6으로 해석됩니다.
Jan 12
- 더 깔끔한 폴리곤에 최적화된 로우폴리 메시를 생성하기 위해 이미지로 3D API에 새로운
model_type파라미터를 추가했습니다.
2025년 12월
Dec 31
- 개발자가 Meshy 웹사이트에서 직접 API 매개변수를 탐색하고 요청을 테스트할 수 있는 전용 공간인 API Playground를 출시했습니다.
- 텍스트 프롬프트를 통한 AI 기반 이미지 생성과 참조 이미지를 통한 이미지 편집을 지원하는 텍스트로 이미지 API 및 이미지로 이미지 API를 도입했습니다. 두 API 모두
nano-banana및nano-banana-pro모델을 지원하며, 선택적으로 멀티뷰 생성을 사용할 수 있습니다.
Dec 22
- 텍스트로 3D API 응답의
video_url필드는 이제 지원 중단되었으며 향후 릴리스에서 제거될 예정입니다.
Dec 04
- 텍스트로 3D 프리뷰, 이미지로 3D 및 멀티 이미지로 3D API에 새로운
pose_mode파라미터가 추가되었습니다. 이 파라미터는a-pose,t-pose또는 빈 문자열(기본값)을 허용합니다.is_a_t_pose파라미터는 이제pose_mode를 대신 사용하도록 지원 중단되었습니다.
2025년 11월
Nov 24
- 이미지로 3D 및 멀티 이미지로 3D API는 선택적
save_pre_remeshed_model파라미터를 추가하고, 리메시 전 백업이 요청되면model_urls.pre_remeshed_glb를 노출합니다.
Nov 06
- 텍스트로 3D Refine API는 이제
ai_model = latest를 지원하며, 이는 Meshy 6 Preview로 해석됩니다. - 이미지로 3D API는 이제
ai_model = latest이고should_texture = true일 때 기본적으로 Meshy-6-preview 텍스처링을 사용합니다. - 멀티 이미지로 3D API는 이제
ai_model = latest를 지원하며, 텍스처링에는 기본적으로 Meshy-6-preview를 실행하고 메시 생성은 Meshy-5로 유지됩니다. - 리텍스처 API는
ai_model에latest옵션(Meshy-6-preview)을 추가하며, 이제 생략된 경우 기본적으로 이를 사용합니다.
Nov 04
2025년 10월
Oct 28
- 현재 API 서버 버전을 나타내기 위해
x-api-version응답 헤더를 추가했습니다.
Oct 20
- 입력 모델 파일의 형식만 변환할 수 있도록 리메시 API에 선택적
convert_format_only불리언 파라미터를 추가했습니다. - 리깅 작업 객체의 응답에
rigged_character_glb_url을 추가했습니다.
Oct 01
text-to-voxelAPI 제거
2025년 9월
Sep 23
- Meshy 6 Preview를 사용하기 위해 텍스트로 3D API의
ai_model에latest옵션을 추가했습니다. - Meshy-6-preview 생성 작업에 대해 10 크레딧으로 임시 50% 할인이 적용되며, 이 할인은 2025년 9월 30일까지 지속됩니다. 할인 기간이 끝나면 Meshy-6-preview 작업 비용은 정상 가격인 20 크레딧으로 돌아갑니다.
Sep 18
Sep 16
- Meshy 6 Preview를 사용하기 위해 이미지로 3D API의
ai_model에latest옵션을 추가했습니다.
Sep 4
2025년 8월
8월 18일
- A/T 포즈로 모델을 생성하기 위해 텍스트로 3D 미리보기, 이미지로 3D, 멀티 이미지로 3D API에 선택적
is_a_t_pose파라미터를 추가했습니다.
Aug 13
2025년 7월
Jul 31
- 텍스트로 3D, 이미지로 3D, 멀티 이미지로 3D, 리텍스처 endpoint에 대해 최신
meshy-5모델에서enable_pbr파라미터를 통해 API에서 PBR 텍스처 맵을 지원합니다.
2025년 6월
Jun 25
- Meshy의 최신 파운데이션 AI 모델을 기반으로 사용자가 3D 모델을 리텍스처할 수 있는 리텍스처 API가 추가되었습니다.
Jun 19
Jun 17
- Webhooks에 대한 문서를 추가했습니다.
Jun 10
- 리메시 API는 이제 Data URI를 통해
model_url파라미터에서 base64로 인코딩된 GLB 형식 모델을 지원합니다.
2025년 5월
May 20
- 텍스트로 3D 프리뷰, 텍스트로 3D 리파인, 이미지로 3D, 멀티 이미지로 3D API에 선택적
moderation파라미터를 추가했습니다. 활성화하면 생성 전에 입력 콘텐츠가 잠재적으로 유해한 콘텐츠인지 자동으로 검사됩니다.
May 15
- 자동 리깅 및 애니메이션 API를 도입하여 사용자가 3D 모델을 자동으로 리깅하고 애니메이션을 적용할 수 있게 했습니다. 리깅에 대해 자세히 알아보기 및 애니메이션.
2025년 4월
Apr 29
meshy-5AI 모델을 사용하여 1~4개의 입력 이미지로부터 3D 모델을 생성할 수 있는 멀티 이미지로 3D API를 도입했습니다.- 텍스트로 3D 및 이미지로 3D API에
meshy-5AI 모델 옵션을 추가했습니다. 이제latest태그도meshy-5로 해석됩니다.
Apr 17
- 이미지로 3D 및 텍스트로 3D 정제 API에
texture_image_url파라미터가 추가되어, 사용자가 이미지를 통해 텍스처 생성 프로세스를 가이드할 수 있습니다.
2025년 3월
Mar 28
Mar 14
- 텍스트로 텍스처 API는 이제 이미지로 3D API의
image_url과 유사하게, Data URI를 통해model_url파라미터에서 base64로 인코딩된 모델을 지원합니다.
Mar 06
- API 생성 작업의 요금이 업데이트되었습니다:
- 텍스트로 3D(미리보기): 호출당 2크레딧에서 5크레딧으로 증가
- 텍스트로 3D(정제): 호출당 5크레딧에서 10크레딧으로 증가
- 이미지로 3D: 이제 텍스처 없이 5크레딧, 텍스처 포함 15크레딧
- 텍스트로 텍스처: 호출당 5크레딧에서 10크레딧으로 증가
- 텍스트로 복셀: 호출당 5크레딧으로 유지
2025년 2월
Feb 18
- 개발자가 크레딧을 소비하지 않고 API 통합을 테스트할 수 있도록 테스트 모드 API 키
msy_dummy_api_key_for_test_mode_12345678를 추가했습니다. 이 키를 사용하는 모든 유효한 요청은 동일한 샘플 작업 결과를 반환합니다.
Feb 13
-
주요 변경 사항:
- 무료 등급 작업 생성은
March 20, 2025에 종료됩니다. 이후에는 모든 API 작업 요청에 유료 구독이 필요합니다. 원활한 액세스를 유지하려면 마감일 전에 업그레이드하는 것을 권장합니다. - 쿠폰 코드
APIACCESS를 사용하여40%할인을 받으세요. 함께해 주셔서 감사합니다!
- 무료 등급 작업 생성은
-
실시간 작업 업데이트를 위한 Server-Sent Events (SSE) 스트리밍 endpoint가 추가되었습니다:
Feb 6
- 이미지로 3D 및 텍스트로 3D Refine API에
texture_prompt파라미터를 추가하여, 사용자가 텍스트 prompt로 텍스처 생성 프로세스를 안내할 수 있도록 했습니다.
2025년 1월
Jan 23
Jan 14
- Meshy-3 AI 모델 기반의 Legacy 텍스트로 3D 및 이미지로 3D API를 지원 중단했습니다.
Jan 07
- 텍스트로 3D 미리보기 및 이미지로 3D API에
symmetry_mode파라미터가 추가되어, 대칭 설정을 구성할 수 있습니다.
2024년 12월
Dec 19
- 사용자가 다른 Meshy API로 생성된 기존 3D 모델을 리메시하고 다양한 형식으로 내보낼 수 있는 리메시 API를 추가했습니다.
- Premium 사용자를 위한 API의 폴리곤 수 제한을 100~300,000 범위로 업데이트했습니다.
Dec 12
- 모든 응답 객체에서
model_url속성을 지원 중단했습니다. - Legacy Meshy-3 API를 최신 Meshy-4 API와 분리했습니다.
Dec 10
- 이미지로 3D 및 텍스트로 3D 정제 API에
enable_pbr파라미터를 추가했습니다. - 이미지로 3D API에
should_texture파라미터를 추가했습니다. meshy-4AI 모델을 사용할 때 텍스트로 3D 미리보기 API의art_style파라미터에서pbr옵션 지원을 중단했습니다.- 텍스트로 3D 미리보기 API의
art_style파라미터에서low-poly옵션 지원을 중단했습니다.
Dec 5
- 사용자가 크레딧 잔액을 조회할 수 있도록 잔액 조회 API를 추가했습니다.
- 이미지로 3D 및 텍스트로 3D 미리보기 API에
should_remesh파라미터를 추가했습니다.
Dec 3
- 외부 API는 이제
/openapi접두사를 사용합니다. Legacy 경로는 계속 지원되지만, 새 경로로 전환하는 것을 권장합니다.
2024년 11월
Nov 14
- 이미지로 3D API는 이제 base64로 인코딩된 이미지를 지원합니다.