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