lowpoly는 2026. 10. 30.에 지원 종료됩니다. 요청 오류를 피하려면 해당 날짜 전에 모델을 전환하세요.

변경 로그

Meshy API와 플러그인의 최신 기능 및 업데이트를 모두 확인하세요.

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

2026년 10월

Oct 15

  • 이미지로 3D 및 텍스트로 3D API에 ai_model: "meshy-t2.5"가 추가되었습니다: 게임 asset을 위한 더 선명한 디테일을 제공하는 최신 Smart Topology 모델입니다. model_type: "smart-topology"와 함께 사용하며, 출력은 삼각형(triangle)으로만 구성되고 target_polycount는 100에서 30,000까지 지정할 수 있습니다(기본값 15,000). 요금은 meshy-t2와 동일합니다. 자세한 내용은 요금을 참고하세요. 이제 ai_model 없이 model_type: "smart-topology"만 설정하면 기본값으로 사용됩니다. 계속 Meshy T2를 사용하려면 ai_model: "meshy-t2"를 설정하세요. 멀티 이미지로 3D는 meshy-t2.5를 지원하지 않습니다.

Oct 14

  • model_url는 Retexture, Remesh, Rigging, Convert, Resize, UV Unwrap, Multi-Color Print, Analyze Printability, Repair Printability에서 http 또는 https URL인 경우 이제 기존 100MB에서 늘어난 최대 400MB까지의 파일을 허용합니다. data: URI는 100MB로 유지됩니다. 100MB를 초과하는 GLB, glTF, FBX 또는 OBJ 파일은 삼각형 기준으로 최대 10,000,000개의 면(Multi-Color Print의 경우 8,000,000개)을 가질 수 있으며, 이를 초과하는 파일은 400을 반환합니다. 100MB를 초과하는 경우, FBX 파일은 반드시 바이너리 FBX 7.1 이상이어야 하며, GLB 또는 glTF 파일은 Draco 압축을 사용하지 않아야 합니다. 파일은 생성 요청이 반환되기 전에 다운로드되므로, 큰 파일의 경우 최대 120초까지 기다려야 할 수 있습니다(작업 생명주기 참조). 100MB 이하의 파일은 이전과 동일하게 동작하며, 요금도 변경되지 않습니다.
  • Analyze Printability는 이제 다른 계정에 속한 input_task_id에 대해 403 대신, 존재하지 않는 id와 동일한 본문과 함께 404를 반환합니다. 본인의 작업이거나, 본인이 속한 작업 공간의 팀원의 작업인 경우에는 이전과 동일하게 동작합니다.

Oct 12

  • USDZ 파일이 이제 미터 단위를 사용하므로, AR Quick Look, Reality Composer, Blender 및 기타 USD 뷰어에서 모델이 실제 크기로 열립니다. 텍스트로 3D, 이미지로 3D, 멀티 이미지로 3D, 리텍스처, 리메시, 변환, 크기 조정, Auto Split 작업의 model_urls에 있는 usdz 파일은 이제 metersPerUnit = 1을 선언합니다. 지금까지는 좌표가 미터 단위였음에도 피트(metersPerUnit = 0.3048)를 선언했기 때문에, 모델이 실제 크기의 30.48%로 표시되었습니다. 이를 보정하기 위해 USDZ 파일을 3.28배로 스케일링하고 있었다면, 이 날짜 이후에 생성된 작업에 대해서는 해당 스케일링을 제거하세요. 이전 작업의 파일은 기존 단위를 그대로 유지하며, Rigging 및 애니메이션 USDZ 파일은 영향을 받지 않습니다.

10월 10일

  • meshy-5가 지원 종료되었습니다. Text to 3D, Image to 3D, Multi-Image to 3D 또는 Retexture에 ai_model: "meshy-5"를 전송하는 요청은 이제 ai_model meshy-5 has been retired; use meshy-6-lite라는 메시지와 함께 400을 반환합니다. 동일한 파라미터와 동일한 크레딧 비용으로 사용할 수 있는 meshy-6-lite로 전환하세요. 이미 meshy-5로 생성한 모델은 계속 사용할 수 있으며, ai_model을 설정하지 않고 meshy-5 프리뷰를 refine하는 것도 계속 정상 작동합니다.
  • .webp가 이제 .jpg, .jpeg, .png와 함께 Image to 3D, Multi-Image to 3D, Image to Image, Retexture (image_style_url) 및 Text to 3D Refine (texture_image_url)에서 지원되는 이미지 입력 형식으로 문서화되었습니다. 공개 URL과 데이터 URI(data:image/webp;base64,...) 모두에서 작동합니다. 기존 연동에는 영향이 없으며, 요금도 변경되지 않습니다.
  • Get Balance가 이제 monthly_credits, permanent_credits, monthly_resets_at도 함께 반환하므로, 다음 갱신 시점에 잔액 중 얼마가 만료되는지 확인할 수 있습니다. balance 자체는 변경되지 않았습니다.

10월 6일

  • 프린팅 가능성 분석과 프린팅 가능성 복구가 이제 원하는 출력 크기 기준으로 벽 두께를 확인할 수 있습니다. printer_type, 출력 크기 또는 둘 다를 전달하면, 분석 시 printability.thin_walls에 얇은 벽을 보고하고, 복구 시 필요한 경우 벽을 두껍게 처리하며, input_task_id로 전달된 분석 작업의 프린터와 크기를 재사용할 수도 있습니다. 이 필드를 사용하지 않는 통합은 이전과 동일하게 동작하며, 요금은 변경되지 않습니다.

2026년 9월

Sep 29

  • /openapi 접두사가 없는 레거시 /v2/text-to-3d 경로는 지원 중단되었습니다. 지금은 변경 없이 그대로 작동하지만 향후 릴리스에서 제거될 예정이므로, 동일한 요청을 받고 동일한 응답을 반환하는 /openapi/v2/text-to-3d로 전환하세요. 레거시 경로의 응답에는 이제 Deprecation 헤더와 새 경로를 가리키는 Link 헤더가 포함됩니다.

Sep 28

  • API 응답에 이제 속도 제한 헤더가 포함되며, 여기에는 재시도나 폴링을 다시 시도하기 전에 얼마나 기다려야 하는지 알려주는 Retry-After도 포함됩니다.
  • Multi-Color Print는 이제 3MF에 일치하는 슬라이서 프리셋을 작성하는 새로운 printer_brand 파라미터를 지원하여, Bambu Lab(기본값)뿐만 아니라 Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker, AnkerMake 프린터에서도 바로 인쇄할 수 있는 상태로 파일이 열립니다. 이 페이지에는 이제 max_depth도 문서화되어 있습니다.

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는 2026년 10월 10일에 폐지됩니다. 텍스트로 3D, 이미지로 3D, 멀티 이미지로 3D, 리텍스처에서 더 이상 ai_model 값으로 문서화되지 않으며, 10월 10일 이후 ai_model: "meshy-5"를 전송하는 요청은 오류를 반환합니다.
  • 공유된 테스트 모드 API 키가 폐지되었습니다. 여전히 이를 전송하는 요청은 이제 401 Unauthorized를 반환합니다. 코드나 CI에 복사해 두셨다면, API 키 페이지에서 발급받은 본인의 키로 교체하세요. 해당 키는 입력값과 관계없이 항상 동일한 샘플 모델을 반환했기 때문에, 요청이 실제로 무엇을 생성할지 보여준 적이 없습니다. 실제로 구축하기 전에 API가 무엇을 반환하는지 확인하려면, 브라우저에서 실제 작업을 실행하는 개발자 플랫폼의 Playground를 사용하세요. API 액세스가 없는 플랜에서는 API 키 없이 이미지로 3D를 실행하며, 다른 모든 작업과 마찬가지로 계정의 크레딧을 사용합니다.

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)으로 분할하며, 선택적으로 장부맞춤(mortise-and-tenon) 커넥터와 얇은 벽 보강을 추가할 수 있습니다. 각 부품을 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를 모두 반환합니다.

Sep 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는 애니메이션 라이브러리 참조를, 요금은 요금 표를 참고하세요.

9월 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

  • Text to Image 및 Image to Image 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 작업에 ultra_mode 파라미터를 도입하여, 추가 5크레딧으로 Ultra 생성을 활성화해 더욱 정교한 표면 디테일을 구현할 수 있습니다. Meshy 7로 텍스처를 적용하려면 refine 작업에 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 preview는 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 — 키캡 API: 사진을 풀컬러 커스텀 기계식 키보드 키캡으로 변환합니다. 2단계 워크플로 — prototype(12 크레딧)이 완성된 키캡 디자인 렌더를 생성하면, build(50 크레딧)가 선택한 디자인(candidate_id 사용)을 GLB 및 OBJ 번들 출력물을 포함한 텍스처가 적용된 3D 키캡 모델로 변환하며, 실제 밀리미터 단위 스케일로 내보냅니다. 현재는 표준 Cherry MX 1u 베이스(cherry-mx-1x1-r1)를 지원하며, 더 많은 표준 사이즈가 추가될 예정입니다. 전체 비용 내역은 요금을 참고하세요.

Jul 21

  • 이제 이미지로 3D, 멀티 이미지로 3D, 텍스트로 3D Refine, 리텍스처 엔드포인트에서 새로운 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 모델로 변환합니다. 전체 내역은 요금을 참고하세요.

Jul 13

  • 이미지로 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 플랜에서 이용할 수 있습니다.

Jun 15

  • 새로운 UV 언래핑 API: 기존 3D 모델에 대해 고품질 UV 레이아웃을 생성합니다 — 텍스처링 이전에 필요한 전제 단계이거나, 다운스트림 도구를 위해 깔끔하고 겹치지 않는 UV 레이아웃이 필요할 때 사용합니다. input_task_id(완료된 이미지로 3D, 텍스트로 3D, 또는 리메시 작업)나 model_url(.glb만 가능) 중 하나를 입력으로 받아 새로운 UV 좌표를 가진 "UV 화이트 모델"을 반환합니다. 호출당 5 크레딧이 소모됩니다. 최대 40,000개 면까지의 메시를 지원하며(더 큰 경우 먼저 리메시를 실행하세요), 쿼드 및 n각형 메시는 UV 생성 과정에서 삼각형으로 분할됩니다.

6월 12일

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

6월 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 크레딧.

May 2026

May 26

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

May 22

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

5월 13일

  • 이미지로 3D API에 multi_view_thumbnails 파라미터가 추가되었습니다. true로 설정하면 작업이 4개의 기본 방향(전면, 우측, 후면, 좌측) 썸네일을 추가로 렌더링하고 새로운 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 상태가 되면 수밀성(watertightness), 부피, 홀 및 비매니폴드 에지 지표를 반환합니다. 무료이며 크레딧이 소모되지 않습니다.
  • 새로운 프린팅 가능성 복구 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을 반환합니다(실패 시 크레딧은 자동으로 환불됩니다). 엔드포인트별 크레딧 비용은 Pricing을 참고하세요.

Apr 24

  • Multi-Color Print 엔드포인트에 model_url 파라미터를 추가했습니다. 이전 Meshy 작업의 input_task_id 대신 텍스처가 적용된 3D 모델을 (URL 또는 Data URI를 통해) 직접 제출할 수 있습니다. 지원되는 형식: .glb, .fbx. model_url과 input_task_id가 모두 제공되는 경우 input_task_id가 우선순위를 가집니다.

Apr 21

  • Image to 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

  • 모든 엔드포인트(이미지로 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, 리메시 endpoint에 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 파라미터를 추가했습니다.

January 2026

Jan 27

  • 400, 401, 402, 404, 422, 429 등 일반적인 HTTP 오류 코드와 작업 실패 원인을 포함하여 모든 API 엔드포인트에 대한 상세한 실패 모드 문서를 추가했습니다. 이를 통해 개발자가 API 오류를 더 잘 이해하고 처리할 수 있습니다.

Jan 26

  • 멀티 이미지로 3D API가 이제 전체 메시 생성을 위한 Meshy-6을 지원합니다. ai_model 파라미터는 이제 meshy-6을 허용하며, latest는 Meshy 6으로 해석됩니다.

1월 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가 기본값입니다.

1월 19일

1월 12일

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

2025년 12월

12월 31일

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

Dec 22

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

Dec 04

  • 텍스트로 3D Preview, 이미지로 3D, 멀티 이미지로 3D API에 새로운 pose_mode 파라미터가 추가되었습니다. 이 파라미터는 a-pose, t-pose, 또는 빈 문자열(기본값)을 허용합니다. is_a_t_pose 파라미터는 이제 지원 중단되었으며 pose_mode로 대체됩니다.

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가 이제 업로드된 모델에 대해 텍스처를 유지합니다.
  • 리텍스처 API는 enable_original_uv 옵션이 활성화된 경우 업로드된 모델에 대해 텍스처를 유지합니다.

October 2025

Oct 28

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

Oct 20

  • 리메시 API에 입력 모델 파일의 형식만 변환하는 것을 지원하기 위해 선택적 불리언 파라미터 convert_format_only가 추가되었습니다.
  • The Rigging Task Object의 응답에 rigged_character_glb_url이 추가되었습니다.

Oct 01

  • text-to-voxel API 제거

September 2025

Sep 23

  • 텍스트로 3D API의 ai_model에 Meshy 6 Preview를 사용할 수 있는 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

8월 13일

  • 텍스트로 3D 및 이미지로 3D(ai_model: meshy-5)에서 Meshy 5가 이제 정식 버전으로 제공되어, 향상된 품질과 일관성을 제공합니다.

2025년 7월

7월 31일

June 2025

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

5월 15일

2025년 4월

4월 29일

  • 멀티 이미지로 3D API가 도입되어 meshy-5 AI 모델을 사용하여 1개에서 4개의 입력 이미지로부터 3D 모델을 생성할 수 있게 되었습니다.
  • 텍스트로 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크레딧으로 유지

2025년 2월

Feb 18

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

Feb 13

  • 주요 변경 사항:

    • 무료 등급 작업 생성은 2025년 3월 20일에 종료됩니다. 이후부터는 모든 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