변경 로그

Meshy API 및 플러그인에 대한 모든 최신 기능과 업데이트를 확인하세요.

실시간 피드를 선호하시나요? 최신 항목은 Developer Platform 개요 페이지에서도 확인할 수 있습니다.

2026년 9월

Sep 18

  • 이미지로 3D, 멀티 이미지로 3D 및 텍스트로 3D에 ai_model 값으로 meshy-7.1이 추가되었습니다: meshy-7과 동일한 매개변수 및 크레딧 비용, 더 높은 지오메트리 디테일을 제공합니다. 이제 latest는 meshy-7.1로 해석되며, meshy-7은 지원 중단되었지만 변경 없이 계속 작동합니다.
  • 동일한 API에 geometry_resolution(standard / 2k / 4k)이 추가되어, 이제 지원 중단된 ultra_mode를 대체합니다(ultra_mode: true는 여전히 작동하며 "2k"와 동일합니다). 4k는 Meshy 7.1(meshy-7.1 또는 latest)이 필요하며, 멀티 이미지로 3D에서는 사용할 수 없고, 2k와 동일하게 5 크레딧이 추가로 소요됩니다.

Sep 16

  • Auto Split API가 이제 텍스처가 적용된 input_task_id를 허용합니다. 이전에는 이를 400으로 거부했기 때문에, 분할을 위해 should_texture: false로 동일한 메시를 한 번 더 생성해야 했습니다. 분할이 반환하는 결과에 유의하세요: 분할은 지오메트리를 자르고 각 부분의 표면을 재구성하므로 입력의 텍스처는 이어지지 않으며, 결과는 부분마다 단색 하나씩만 있는 텍스처 없는 모델이 됩니다 — 이는 모든 분할에서 이미 그랬던 것이며 변경되지 않았습니다.
  • meshy-5는 더 이상 제공되지 않습니다. 텍스트로 3D, 이미지로 3D, 멀티 이미지로 3D 또는 리텍스처에서 ai_model 값으로 더 이상 사용할 수 없습니다. 통합에서 ai_model: "meshy-5"를 전송하는 경우, meshy-6-lite로 전환하세요 — 동일한 매개변수를 사용하며 비용도 동일합니다.

Sep 15

  • 텍스트로 이미지 및 이미지로 이미지 API에서 문서화된 ai_model 값에 gpt-image-2-5-flare 및 gpt-image-2-5-sunburst가 추가되었습니다. 이는 OpenAI GPT Image 2.5 등급으로, gpt-image-2와 동일한 가격으로 책정되어 있습니다(텍스트로 이미지: 9 크레딧, 이미지로 이미지: 12 크레딧).
  • GPT Image 모델(gpt-image-2, gpt-image-2-5-flare, gpt-image-2-5-sunburst)은 이제 텍스트로 이미지 및 이미지로 이미지 API에서 1:1, 16:9, 9:16, 3:2, 2:3 외에 4:3 및 3:4 종횡비도 지원합니다.

Sep 14

  • 이미지로 이미지 API가 이제 input_task_id를 받을 수 있습니다 — 완료된 텍스트로 이미지 또는 이미지로 이미지 작업의 결과 URL을 reference_image_urls에 복사할 필요 없이 바로 이어서 연결할 수 있습니다.

Sep 11

  • 동작 변경: 이미 IN_PROGRESS 상태인 작업에 대한 DELETE는 이제 409 Conflict로 거부되며, 해당 작업은 계속 실행된 상태로 남습니다. 이전에는 200 OK를 반환하고 워커를 중지시킨 뒤 결과를 폐기했지만 — 크레딧은 그대로 유지되었는데, 이는 PENDING 상태의 작업만 환불 대상이었기 때문이며, 결과적으로 이 호출은 응답에 아무런 안내 없이 모델과 크레딧을 모두 소모시켰습니다. 통합 과정에서 작업을 취소하기 위해 삭제를 사용하고 있다면, 워커가 이미 시작한 작업은 취소할 수 없다는 점에 유의하세요: SUCCEEDED, FAILED 또는 CANCELED 상태가 될 때까지 기다린 후 삭제해야 합니다. PENDING 작업은 이전과 동일하게 삭제 및 환불되며, 종료 상태의 작업 역시 그대로 삭제됩니다. 이는 /openapi 하위의 모든 작업 계열에 적용됩니다. 오류를 참고하세요.
  • 텍스트로 3D, 이미지로 3D, 멀티 이미지로 3D, 리텍스처 API에 문서화된 ai_model 값에 meshy-6-lite가 추가되었습니다. 이는 meshy-5의 후속 모델로, 매개변수와 크레딧 비용(메시는 5, 텍스처 포함 시 15, 리텍스처는 10)이 동일합니다.
  • meshy-5는 이제 이를 지원하는 모든 API에서 지원 중단되었습니다. 계속 작동하며 요청이나 비용에는 변화가 없지만, 향후 릴리스에서 신규 트래픽을 받지 않게 됩니다 — 통합 코드에서 ai_model: "meshy-5"를 전송하고 있다면 meshy-6-lite로 마이그레이션하세요.

Sep 9

  • 새로운 Auto Split API: 텍스처가 적용되지 않은 Meshy 6 또는 Meshy 7 모델을 자동으로, 지정한 부품 단위로(by_parts), 또는 색상 영역별로(by_color) 개별적으로 출력 가능한 파츠로 분할할 수 있습니다 — 촉과 홈 연결 구조 및 얇은 벽 보강 옵션도 지원합니다. 각 파츠를 glb, obj, fbx, usdz, blend, 또는 3mf 형식의 개별 오브젝트로 내보내며, 조립된 상태 또는 빌드 플레이트에 배치된 상태(layout)로 내보낼 수 있습니다. 작업당 10크레딧이 소요됩니다.

Sep 7

  • Creative Lab Keychain API의 프로토타입 단계에 name_text 파라미터가 추가되었습니다: 웹 앱에서 제공하는 것과 동일한 개인화 기능으로, 키링에 최대 10자까지 이름을 각인할 수 있습니다. 빌드 단계는 이 각인 내용을 자동으로 상속하며, 이제 프로토타입 작업 객체가 name_text를 반환하므로 빌드 전에 정확한 텍스트를 확인할 수 있습니다. 참고로 name은 여전히 표시 전용 작업 라벨이며 실제로 각인되지 않습니다.

9월 5일

  • Creative Lab Fidget Pixel API를 추가했습니다: 사진을 2단계에 걸쳐 다색 3D 프린팅이 가능한 픽셀 아트 피젯 보드로 변환합니다. POST /prototype(6 크레딧)은 사진을 픽셀 아트 이미지로 픽셀화하며 — type을 person 또는 other로 전달하여 픽셀화 스타일을 선택할 수 있습니다 — POST /build(30 크레딧)는 이를 16 또는 32 그리드에 샘플링하고 각 픽셀을 맞물리는 square 또는 hex 조각으로 변환하여, 다중 필라멘트 프린팅을 위한 단일 색상 태그가 지정된 3MF로 제공합니다. 조각 지오메트리는 piece_size_mm, color_count, piece_height_mm를 통해 조정할 수 있습니다.

Sep 4

  • Animation Library에 GET /openapi/v1/animations/library를 추가했습니다: Animation API가 지원하는 모든 프리셋 액션 — action_id, 이름, 카테고리, 애니메이션 GIF 미리보기 — 를 검색 및 카테고리 필터와 함께 가져올 수 있어, 참조 표를 읽는 대신 직접 액션 선택기를 만들 수 있습니다. 무료이며 크레딧을 소모하지 않습니다.
  • Creative Lab Collapsible Fidget API를 추가했습니다: 사진을 프린트 후 바로 사용 가능한 접이식 피젯 토이로 변환하며, 피사체의 실루엣이 평평하게 접혔다가 다시 펼쳐지는 중첩된 동심원 형태가 되어, 조립 없이 한 조각으로 출력됩니다. 단일 POST 요청으로 이미지가 완성된 모델까지 처리되며 — 프로토타입/빌드 단계 쌍이나 조정할 지오메트리 매개변수가 없습니다. 각 작업은 6 크레딧이 소모되며 출력 가능한 STL과 미리보기용 GLB를 모두 반환합니다.

9월 3일

  • Creative Lab Lamp API의 prototype 단계가 이제 3D 모델을 반환합니다: POST /prototype은 콘셉트 이미지를 속이 빈 램프갓 GLB로 변환하며, prototype 작업 객체는 image_urls와 함께 model_urls.glb 및 thumbnail_url을 갖게 됩니다. build 단계는 해당 모델에 대해 램프 프로세서만 실행하며, 이제 광원 조명기구용 받침판이 있는 바닥이 뚫린 램프갓을 생성합니다. 요금도 이에 맞춰 변경됩니다: prototype은 30 크레딧, build는 6 크레딧입니다(이전에는 각각 6, 30이었습니다). prototype의 text 파라미터는 제거되었으며 — image_url이 필수입니다.

Sep 2

  • 애니메이션 API가 이제 action_ids를 지원합니다 — 리깅된 캐릭터에 최대 10개의 프리셋 액션을 한 번의 요청으로 적용하고, 액션당 하나의 애니메이션 클립이 포함된 단일 파일을 받아 게임 엔진의 상태 머신에서 바로 구동할 수 있습니다. 클립은 나열한 순서를 유지하며 애니메이션의 라이브러리 이름을 포함합니다. 액션당 3크레딧이 소요되며, post_process는 병합된 파일에 적용됩니다. 사용 가능한 id는 애니메이션 라이브러리 참조를, 요금은 요금 표를 참조하세요.

Sep 1

  • 멀티 이미지로 3D API에 ultra_mode 파라미터가 추가되었습니다: ai_model meshy-7(또는 latest)에서 Ultra 생성을 활성화하여 더 정교한 표면 디테일을 갖춘 고충실도 지오메트리를 추가 크레딧 5개로 제공합니다 — 이는 이미지로 3D API가 제공하는 것과 동일한 Ultra 패스이며, 이제 멀티뷰 입력에서도 사용할 수 있습니다.
  • 이미지로 3D API의 Smart Topology model_type에 문서화된 ai_model 값에서 meshy-t1이 제거되었습니다. Smart Topology는 이제 meshy-t2만 문서화하며, 새로운 통합에서는 이를 대신 사용해야 합니다. Meshy T1은 지원 중단이 예정되어 있습니다 — 현재 통합에서 ai_model: "meshy-t1"을 전송하고 있다면 meshy-t2로 마이그레이션하세요.

August 2026

Aug 28

  • Studio 및 Enterprise 팀을 위한 Usage API가 추가되었습니다: 엔드포인트, 상태, 타임스탬프, 각 작업을 실행한 API 키, consumed_credits를 포함한 과거 API 작업 사용 내역을 프로그래밍 방식으로 내보낼 수 있으며, 비용 추적 및 재무 시스템을 위한 표준 페이지네이션과 시간 범위, 엔드포인트, 상태 필터를 제공합니다.

Aug 26

  • Animation API가 이제 motion_task_id를 지원합니다 — 사전 설정된 action_id 대신, Text to Motion API로 생성한 모션 클립을 리그가 적용된 이족보행 캐릭터에 적용할 수 있습니다. 작업당 크레딧은 동일하게 3 크레딧입니다.

Aug 24

  • 텍스트로 이미지 및 이미지로 이미지 API에서 gpt-image-2의 aspect_ratio 지원을 확장하여 16:9와 9:16을 추가했습니다. 이제 gpt-image-2는 1:1, 16:9, 9:16, 3:2, 2:3을 지원하며, 4:3과 3:4는 이 모델에서 여전히 지원되지 않습니다.

Aug 21

  • Text to Motion API를 추가했습니다: 캐릭터 모델 없이 자연어 설명만으로 캐릭터 모션 클립을 생성합니다. 최고 품질을 원한다면 prime mode(10 크레딧, FBX 출력)를, 빠르고 경제적인 생성을 원한다면 swift mode(3 크레딧, BVH 출력)를 선택하세요. 클립 길이는 2~10초입니다.

Aug 20

  • 다색 프린트 API에 style 파라미터를 추가했습니다: 텍스처 그대로의 색상을 위한 realistic(기본값) 또는 균일한 색상 영역과 더 작은 3MF를 위한 cartoon 중에서 선택할 수 있습니다.
  • 모든 Creative Lab 프로토타입 엔드포인트 — Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet, Lamp — 에 remove_background 파라미터를 추가했습니다. remove_background: true로 설정하면 배경이 제거된 투명 RGBA PNG 형태로 프로토타입 이미지를 받을 수 있습니다.

Aug 18

  • 멀티 이미지로 3D API에 texture_image_urls 파라미터를 추가했습니다: 단일 texture_image_url 대신 동일한 객체의 이미지를 1~4장 제공하여 텍스처링을 안내할 수 있습니다. ai_model meshy-7 또는 latest가 필요하며, image_urls와는 독립적으로 작동합니다 — 두 목록은 서로 다른 이미지와 서로 다른 개수의 이미지를 포함할 수 있습니다.

Aug 17

Aug 13

  • 텍스트로 3D API에 ai_model: "meshy-7"을 추가했습니다: Meshy 6보다 더 높은 충실도의 지오메트리를 제공하는 최신 3D 생성 모델입니다. 또한 preview task에 ultra_mode 파라미터가 새로 도입되어, 추가 5 크레딧으로 더욱 정교한 표면 디테일을 위한 Ultra 생성을 활성화할 수 있습니다. Meshy 7로 텍스처링하려면 refine task에서 ai_model: "meshy-7"을 전달하거나 ai_model을 아예 생략하세요.
  • 텍스트로 3D API에 Smart Topology model_type을 추가했습니다. model_type: "smart-topology"를 설정하면 meshy-t2로 생성되며, 더 깔끔한 topology, 네이티브로 분리된 파츠, 삼각형 출력, 그리고 target_polycount(100~15,000, 기본값 4,000)로 설정 가능한 면 수를 제공합니다. Smart Topology 프리뷰는 20 크레딧 대신 5 크레딧이 소요됩니다. 자세한 내용은 요금을 참고하세요. 기존의 model_type: "lowpoly"는 이제 지원 중단되었지만, 하위 호환성을 위해 계속 트래픽을 처리합니다.

Aug 12

  • 이미지로 3D API에 ai_model: "meshy-7"를 추가했습니다: Meshy 6보다 더 높은 충실도의 지오메트리를 제공하는 최신 3D 생성 모델입니다. 또한 더욱 정교한 표면 디테일을 위한 Ultra 생성 기능을 활성화하는 ultra_mode 파라미터도 도입되었습니다.
  • 멀티 이미지로 3D API에 ai_model: "meshy-7"를 추가했습니다: 입력된 모든 뷰를 함께 조건으로 사용하여 이를 기반으로 텍스처링을 진행하는 Meshy의 멀티뷰 생성 모델입니다.
  • 리텍스처 API에 ai_model: "meshy-7"를 추가했습니다: Meshy 6보다 더 선명한 표면 디테일과 더 깔끔한 PBR 재질을 제공하는 최신 텍스처링 모델입니다. 또한 동일한 객체에 대해 1~4개의 순서가 지정된 뷰를 제공하여 멀티뷰 텍스처링을 진행할 수 있는 multiview_image_urls 파라미터도 도입되었습니다.

Aug 4

  • 프린팅 가능성 분석 및 프린팅 가능성 복구 엔드포인트에서 model_url 입력 지원을 .glb, .gltf, .obj, .fbx, .stl로 확장했습니다 (이전에는 .glb, .stl, .obj). 복구는 복구된 asset을 입력 형식 그대로 반환합니다.

July 2026

Jul 27

  • 새로운 Creative Lab — Brick Figure API: 사진을 브릭 스타일의 수집형 3D 미니피규어로 변환합니다. Figure API와 동일한 2단계 워크플로우 — prototype(6 크레딧)은 스타일이 적용된 컨셉 이미지를 생성하고, build(30 크레딧)는 이를 GLB 및 OBJ + MTL 출력을 포함한 텍스처가 적용된 3D 모델로 변환합니다. 전체 세부 내용은 요금을 참고하세요.

Jul 22

  • 신규 Creative Lab — Keycap API: 사진을 풀컬러 커스텀 기계식 키보드 키캡으로 변환합니다. 2단계 워크플로우 — prototype(12 크레딧)은 완성된 키캡 디자인 렌더를 생성하고, 이후 build(50 크레딧)은 (candidate_id를 통해) 선택한 디자인을 GLB 및 OBJ 번들 출력을 포함한 텍스처가 적용된 3D 키캡 모델로 변환하며, 실제 밀리미터 단위 스케일로 내보냅니다. 현재는 표준 Cherry MX 1u 베이스(cherry-mx-1x1-r1)를 지원하며, 더 많은 표준 사이즈가 계획되어 있습니다. 전체 세부 내역은 요금을 참고하세요.

Jul 21

  • 이제 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D Refine, 리텍스처 endpoint에서 새로운 texture_resolution 파라미터(2k / 4k / 8k)를 통해 8K 베이스 컬러 텍스처를 지원합니다. 8k에서는 PBR 맵이 4K로 생성되며 emission 맵은 생성되지 않습니다. 8K 텍스처 생성 비용은 15크레딧입니다(2k/4k는 그대로 10크레딧). 요금을 참고하세요.
  • hd_texture 불리언은 texture_resolution으로 대체되어 지원 중단되었지만, 하위 호환성을 위해 여전히 유효하며 texture_resolution: "4k"와 동일하게 동작합니다.

Jul 20

  • 새로운 Creative Lab — Vinyl Figure API: 사진을 커다란 머리를 가진 비닐 수집형 3D 피규어로 변환합니다. Figure API와 동일한 2단계 워크플로우로, prototype(6 크레딧)은 스타일이 적용된 콘셉트 이미지를 생성하고, build(30 크레딧)는 이를 GLB 및 OBJ + MTL 출력을 포함한 텍스처가 적용된 3D 모델로 변환합니다. 전체 세부 내역은 Pricing을 참고하세요.

Jul 13

  • Image to 3D API에 새로운 Smart Topology model_type이 추가되어, ai_model을 통해 두 가지 모델을 제공합니다: meshy-t1 — 기존의 로우폴리 모델 — 그리고 meshy-t2 — 더 깔끔한 topology, 네이티브로 분리된 파츠, 삼각형 출력, 그리고 target_polycount로 설정 가능한 면 개수를 제공하는 새로운 모델입니다. meshy-t2는 smart-topology의 기본값입니다. 기존의 model_type: lowpoly는 이제 지원 중단되었지만, 하위 호환성을 위해 계속 트래픽을 처리합니다.

Jul 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와 함께 사용할 수 없습니다.

June 2026

Jun 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각형 메시는 UV 생성 과정에서 삼각형으로 분할됩니다.

Jun 12

  • Keychain, Fridge Magnet, Figure의 Creative Lab API Build 요금을 호출당 30크레딧으로 업데이트했습니다 (이전 20크레딧). Lamp는 30크레딧으로 변경 없이 유지됩니다. Prototype 요금은 이미지당 6크레딧으로 변경 없이 유지됩니다. 전체 내역은 Pricing을 참고하세요.

Jun 5

  • Image to 3D, Multi-Image to 3D, Text to 3D, Retexture, Remesh, Repair Printability API에 선택적 alpha_thumbnail 파라미터가 추가되었습니다. true로 설정하면 작업이 추가로 투명 배경(RGBA) 버전의 미리보기를 렌더링하여 새로운 alpha_thumbnail_url 응답 필드로 반환합니다. 기존의 thumbnail_url은 변경되지 않습니다. 기본값은 false입니다.

Jun 1

  • 새로운 Creative Lab API: 원본 사진(또는 텍스트 prompt)을 3D 프린팅이 가능한 소비자 제품으로 변환하는 제품별 endpoint 모음입니다. 출시 시점에는 키링, 냉장고 자석, 피규어, 램프의 네 가지 제품이 제공됩니다. 각 제품은 input_task_id로 연결되는 prototype → build의 2단계 워크플로우를 따르며, 제품별 URL(/openapi/creative-lab/<product>/v1/...) 아래에서 제공되고 제품별 버전 관리를 통해 각 제품이 독립적인 버전 라인으로 발전할 수 있습니다. Prototype: 호출당 6크레딧. Build: 호출당 30크레딧.

2026년 5월

May 26

  • 멀티 이미지로 3D API에 multi_view_thumbnails 파라미터가 추가되었습니다. true로 설정하면 작업이 네 방향(정면, 우측, 후면, 좌측)의 썸네일을 추가로 렌더링하여 새로운 thumbnail_urls 응답 필드로 반환합니다. 기존 thumbnail_url 필드는 변경되지 않습니다. 작업 지연 시간이 약 3초 늘어납니다.

May 22

  • Remesh API의 변환 및 크기 조정 기능이 이제 독립적인 Convert API 및 Resize API 엔드포인트로 제공됩니다. Remesh의 지원 중단된 파라미터는 하위 호환성을 위해 계속 작동합니다.

5월 13일

  • 이미지로 3D API에 multi_view_thumbnails 파라미터가 추가되었습니다. true로 설정하면 작업이 네 방향(정면, 오른쪽, 후면, 왼쪽)의 썸네일을 추가로 렌더링하고, 이를 새로운 thumbnail_urls 응답 필드로 반환합니다. 기존의 thumbnail_url 필드는 변경되지 않습니다. 작업 지연 시간이 약 3초 증가합니다.

5월 12일

  • 리메시 API에 resize_longest_side 파라미터가 추가되었습니다. 바운딩 박스에서 가장 긴 치수가 지정된 값(미터 단위)과 같아지도록 모델 크기를 조정합니다. resize_height 및 auto_size와는 함께 사용할 수 없습니다.

5월 11일

5월 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 엔드포인트에 input_task_id 파라미터가 추가되었습니다. image_url / image_urls를 제공하는 대신 완료된 텍스트로 이미지 또는 이미지로 이미지 작업의 출력을 직접 참조할 수 있습니다. 둘 다 제공된 경우 input_task_id가 우선순위를 가집니다.

Apr 20

Apr 14

Apr 12

  • API 문서 구조를 재구성했습니다: 종속 필드가 있는 파라미터 그룹화, 인라인 기본값, 필수/지원 중단 배지, 확장 가능한 하위 내비게이션을 추가하고, Multi-Image, Rigging, Animation을 별도 페이지로 분리했습니다.

2026년 3월

Apr 2

  • 모든 endpoint(이미지로 3D, 텍스트로 3D, 리메시, 리텍스처)의 target_formats 파라미터에 3mf 형식 지원이 추가되었습니다. 참고: 3MF는 선택적 사항이며 명시적으로 요청해야 합니다.
  • 새로운 다색 프린트 API: 3D 모델을 3D 프린팅용 다색 3MF 형식으로 변환합니다. 1~16색 팔레트를 지원하며 정밀도를 설정할 수 있습니다. 작업당 10크레딧이 소요됩니다.

3월 20일

  • Meshy-4 AI 모델이 지원 종료되었습니다. meshy-4를 사용하는 모든 API 요청은 더 이상 지원되지 않습니다. meshy-6 또는 latest로 마이그레이션해 주세요.
  • 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D, 리메시 엔드포인트에 auto_size 및 origin_at 파라미터가 추가되었습니다. auto_size를 활성화하면 서비스가 AI 비전을 사용하여 실제 높이를 추정하고 모델의 크기를 자동으로 조정합니다. origin_at은 원점 위치(bottom 또는 center)를 설정합니다. Remesh API에서 auto_size는 resize_height와 상호 배타적입니다.

Mar 17

February 2026

Feb 28

Feb 25

  • 입력 이미지의 최적화를 원하지 않고 입력 이미지의 외형을 그대로 유지하려는 사용자를 위해 이미지로 3D 및 멀티 이미지로 3D API에 image_enhancement 파라미터를 추가했습니다. meshy-6 및 latest에서만 지원됩니다. 기본값은 true입니다.

Feb 20

  • 더 깔끔한 폴리곤에 최적화된 로우폴리 메시를 생성할 수 있도록 Text to 3D Preview 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으로 지정됩니다.

1월 22일

  • 텍스트로 3D Preview API(Meshy-6)에서 art_style을 지원 중단했습니다. 이 파라미터는 레거시 모델(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

Jan 12

  • 더 깔끔한 폴리곤에 최적화된 로우폴리 메시를 생성할 수 있도록 이미지로 3D API에 새로운 model_type 파라미터가 추가되었습니다.

December 2025

Dec 31

  • 개발자가 Meshy 웹사이트에서 API 파라미터를 직접 살펴보고 요청을 테스트할 수 있는 전용 공간인 API Playground를 출시했습니다.
  • 텍스트 프롬프트로부터 AI 기반 이미지 생성과 참조 이미지로부터의 이미지 편집을 가능하게 하는 텍스트로 이미지 API 및 이미지로 이미지 API를 도입했습니다. 두 API 모두 nano-banana 및 nano-banana-pro 모델을 지원하며, 선택적으로 멀티뷰 생성을 지원합니다.

Dec 22

  • 텍스트로 3D API 응답의 video_url 필드는 이제 지원 중단되었으며 향후 릴리스에서 제거될 예정입니다.

Dec 04

November 2025

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-5를 유지하면서 텍스처링은 기본적으로 Meshy-6-preview로 실행됩니다.
  • 리텍스처 API에 ai_model용 latest 옵션(Meshy-6-preview)이 추가되었으며, 생략 시 이제 이 옵션이 기본값으로 사용됩니다.

Nov 04

  • 리메시 API가 이제 업로드된 모델의 텍스처를 보존합니다.
  • enable_original_uv 옵션이 활성화된 경우, 리텍스처 API가 이제 업로드된 모델의 텍스처를 보존합니다.

October 2025

Oct 28

  • 현재 API 서버 버전을 나타내기 위해 x-api-version 응답 헤더가 추가되었습니다.

Oct 20

  • 입력 모델 파일의 포맷 변환만 지원하기 위해 리메시 API에 선택적 boolean parameter인 convert_format_only가 추가되었습니다.
  • The Rigging Task Object의 응답에 rigged_character_glb_url이 추가되었습니다.

Oct 01

  • text-to-voxel API 제거

September 2025

Sep 23

  • Meshy 6 Preview를 사용하기 위해 텍스트로 3D API의 ai_model에 latest 옵션을 추가했습니다.
  • Meshy-6-preview 생성 작업에 대해 2025년 9월 30일까지 유지되는 50% 임시 할인이 적용되어 10 크레딧으로 제공됩니다. 할인 기간이 종료되면 Meshy-6-preview 작업 비용은 원래대로 20 크레딧으로 돌아갑니다.

Sep 18

Sep 16

  • 이미지로 3D API의 ai_model에 Meshy 6 Preview를 사용할 수 있는 latest 옵션이 추가되었습니다.

Sep 4

  • 리메시 및 리텍스처에서 model_url 입력 지원이 .glb, .gltf, .obj, .fbx, .stl로 확장되었습니다.

August 2025

Aug 18

Aug 13

2025년 7월

Jul 31

2025년 6월

Jun 25

  • Meshy의 최신 파운데이션 AI 모델을 기반으로 3D 모델을 리텍스처할 수 있는 Retexture API를 추가했습니다.

Jun 19

Jun 17

  • Webhooks에 대한 문서를 추가했습니다.

Jun 10

  • 리메시 API가 이제 model_url 파라미터에서 Data URI를 통해 base64로 인코딩된 GLB 형식 모델을 지원합니다.

May 2025

May 20

May 15

April 2025

Apr 29

  • meshy-5 AI 모델을 사용하여 1개에서 4개의 입력 이미지로부터 3D 모델을 생성할 수 있는 멀티 이미지로 3D API를 도입했습니다.
  • 텍스트로 3D 및 이미지로 3D API에 meshy-5 AI 모델 옵션을 추가했습니다. 이제 latest 태그도 meshy-5로 연결됩니다.

Apr 17

  • 이미지로 3D 및 텍스트로 3D Refine API에 texture_image_url 파라미터를 추가하여, 사용자가 이미지를 통해 텍스처 생성 과정을 가이드할 수 있도록 했습니다.

March 2025

Mar 28

  • 텍스트로 3D 및 이미지로 3D API에 latest 파라미터를 추가하여, 향상된 생성 품질을 제공하는 차세대 고급 AI 모델에 접근할 수 있도록 했습니다.

Mar 14

Mar 06

  • API 생성 작업에 대한 요금이 업데이트되었습니다:
    • 텍스트로 3D (Preview): 호출당 2 크레딧에서 5 크레딧으로 인상
    • 텍스트로 3D (Refine): 호출당 5 크레딧에서 10 크레딧으로 인상
    • 이미지로 3D: 이제 텍스처 미포함 시 5 크레딧, 텍스처 포함 시 15 크레딧
    • 텍스트로 텍스처: 호출당 5 크레딧에서 10 크레딧으로 인상
    • Text to Voxel: 호출당 5 크레딧으로 동일하게 유지

February 2025

Feb 18

  • 크레딧을 소모하지 않고 API 통합을 테스트할 수 있는 테스트 모드 API 키를 추가했습니다. 이 키를 사용한 모든 유효한 요청은 동일한 샘플 작업 결과를 반환합니다.

Feb 13

  • 주요 변경 사항:

    • 무료 등급 작업 생성은 March 20, 2025에 종료됩니다. 이후에는 모든 API 작업 요청에 유료 구독이 필요합니다. 원활한 이용을 위해 마감일 전에 업그레이드하시는 것을 권장합니다.
    • 쿠폰 코드 APIACCESS를 사용하면 40% 할인을 받을 수 있습니다. 함께해 주셔서 감사합니다!

  • 실시간 작업 업데이트를 위한 Server-Sent Events (SSE) 스트리밍 endpoint를 추가했습니다:

Feb 6

  • 이미지로 3D 및 텍스트로 3D Refine API에 texture_prompt 파라미터를 추가하여, 사용자가 텍스트 prompt로 텍스처 생성 과정을 안내할 수 있도록 했습니다.

January 2025

Jan 23

Jan 14

  • Meshy-3 AI 모델 기반의 지원 중단된 레거시 텍스트로 3D 및 이미지로 3D API를 지원 중단했습니다.

Jan 07

December 2024

Dec 19

  • 다른 Meshy API로 생성된 기존 3D 모델을 리메시하고 다양한 형식으로 내보낼 수 있는 리메시 API를 추가했습니다.
  • Premium 사용자를 위한 API의 폴리곤 수 제한을 100~300,000 범위로 업데이트했습니다.

Dec 12

  • 모든 응답 객체에서 model_url 속성을 지원 중단했습니다.
  • 지원 중단된 Meshy-3 API를 최신 Meshy-4 API와 분리했습니다.

Dec 10

Dec 5

Dec 3

  • 외부 API가 이제 /openapi 접두사를 사용합니다. Legacy 경로는 계속 지원되지만, 새 경로로 전환하는 것을 권장합니다.

November 2024

Nov 14

  • Image to 3D API가 이제 base64로 인코딩된 이미지를 지원합니다.