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

변경 로그

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

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

November 2026

Nov 3

  • 이미지로 3D와 멀티 이미지로 3D에 texture_model이 추가되어, 메시와 동일한 작업에서 텍스처 모델을 선택할 수 있습니다. 이미지로 3D는 모든 ai_model에서 Meshy 7(meshy-7), Meshy N1(meshy-n1), Meshy 6 Lite(meshy-6-lite)를 지원합니다. 멀티 이미지로 3D는 멀티뷰 텍스처 모델인 Meshy 7과 Meshy N1을 지원합니다. 각 텍스처 모델은 자체 한도를 유지합니다. 모델을 참고하세요. 작업 비용은 해당 ai_model의 메시 전용 가격에 해당 텍스처 해상도의 리텍스처 가격을 더한 값입니다. 요금을 참고하세요. texture_model이 없는 요청은 기존과 동일하게 동작합니다.
  • 텍스트로 3D refine에 ai_model: "meshy-n1"이 추가되었습니다. texture_image_url이 없으면, Meshy N1은 Meshy 7.1 또는 latest 미리보기가 저장한 참조 이미지로 텍스처를 생성합니다. 다른 미리보기는 texture_image_url이 필요합니다. Meshy N1을 사용한 refine은 10크레딧이 소요됩니다.

11월 2일

  • Retexture API에 ai_model: "meshy-n1"이 추가되었습니다. Meshy N1은 한 장에서 네 장의 참조 이미지로 2K 베이스 컬러 텍스처를 생성합니다. 이미지가 두 장 이상인 경우 첫 번째 이미지가 정면 뷰가 되며, 나머지 이미지의 순서는 Meshy 7과 마찬가지로 상관없습니다. 텍스트 prompt를 받지 않으며, PBR 맵이나 4K, 8K 텍스처는 생성하지 않고, 최대 7,999,999개의 면을 가진 3D 모델에 텍스처를 입힐 수 있습니다. 작업 하나당 2K 리텍스처와 동일한 10 크레딧이 소요됩니다. 자세한 내용은 요금을 참고하세요. latest는 여전히 Meshy 7로 연결됩니다.

2026년 10월

Oct 30

  • 텍스트로 3D 및 이미지로 3D에서 일부 Meshy T1 요청(model_type: "lowpoly" 또는 ai_model: "meshy-t1")이 이제 Smart Topology에서 실행되며, 나머지는 400을 반환합니다. ai_model: "meshy-t2.5"를 사용하는 model_type: "smart-topology"가 T1을 대체합니다. 2026년 11월 30일부터는 모든 T1 요청이 400을 반환합니다. 어떤 요청이 계속 실행되는지는 지원 중단 문서에 정리되어 있습니다.
  • Auto Split API에 새로운 선택적 파라미터인 keep_texture가 추가되었습니다. keep_texture: true로 설정하면 텍스처가 적용된 모델의 모든 부분이 텍스처를 유지하며, 작업은 texture_urls에 텍스처 맵을 반환하고 OBJ와 함께 mtl 파일도 반환합니다. 이 옵션을 사용하지 않으면 분할은 기존과 동일하게 작동합니다. 텍스처를 유지하는 분할은 시간이 약 두 배 더 걸리며, 비용은 여전히 10크레딧입니다. input_task_id는 텍스트로 3D의 refine 및 리텍스처 작업도 지원합니다.

Oct 26

  • 새로운 지원 중단 페이지: 모든 3D 생성 모델의 생명 주기(활성, legacy, 지원 중단, 또는 종료)와 종료일 및 권장 대체 항목, 모든 API 지원 중단 이력, 그리고 여전히 서비스 중인 지원 중단 파라미터를 확인할 수 있습니다. API 페이지의 종료 안내 배너는 이제 이 페이지로 연결됩니다.

Oct 23

  • Rigging에서 texture_image_url이 지원 중단되었습니다. Meshy는 model_url 파일에 포함된 텍스처나 입력 작업의 텍스처를 사용하므로, 모델이 자체 텍스처를 가지고 있다면 이 값을 생략하세요. 이 값을 전송하면 해당 이미지가 리깅된 모델의 유일한 텍스처가 되며, 모델은 PBR 맵을 잃게 됩니다.

Oct 21

  • 작업을 생성하는 모든 엔드포인트(단, Creative Lab 엔드포인트는 제외)에 Studio 및 Enterprise 팀을 위한 X-Meshy-Metadata 헤더가 추가되었습니다. user=alex@example.com,team=fab와 같이 자신만의 키-값 쌍으로 작업에 태그를 지정하고, Usage 레코드의 metadata 필드에서 이를 다시 읽을 수 있습니다. 자세한 내용은 Metadata를 참고하세요.

Oct 19

  • Keychain 및 Fridge Magnet 빌드 작업에서 export_resolution이 허용하는 값이 기존 2048에서 최대 512까지로 축소되었습니다. 512는 지오메트리가 생성되는 기반이 되는 깊이 맵(depth map)의 해상도이므로, 이보다 높은 값을 설정하면 이미 존재하는 샘플들 사이에 추가 정점(vertex)이 배치되어 동일한 표면을 설명하는 더 큰 파일이 생성될 뿐이었습니다. 512는 기본값이기도 하므로, export_resolution을 한 번도 설정하지 않은 호출에는 영향이 없습니다. 이제 512를 초과하는 값을 설정하면 생성 시점에 작업이 수락되는 대신 400이 반환됩니다. 특히 2048은 항상 생성기(generator)의 처리 시간 제한을 초과하여 작업이 시작된 후 실패하곤 했습니다. export_resolution을 512보다 높게 설정한 경우, 해당 파라미터를 제거하거나 512로 설정하세요.

Oct 15

  • 이미지로 3D 및 텍스트로 3D API에 ai_model: "meshy-t2.5"를 추가했습니다: 게임 에셋에 더욱 선명한 디테일을 제공하는 최신 Smart Topology 모델입니다. model_type: "smart-topology"와 함께 사용하며, 출력은 삼각형 전용이고 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

  • Retexture, Remesh, Rigging, Convert, Resize, UV 언래핑, Multi-Color Print, 프린팅 가능성 분석, 프린팅 가능성 복구에서 model_url이 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 이하의 파일은 기존과 동일하게 동작하며, 요금도 변경되지 않습니다.
  • 프린팅 가능성 분석은 이제 다른 계정에 속한 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배로 스케일링하고 있었다면, 이 날짜 이후 생성된 작업에 대해서는 해당 스케일링을 제거하세요. 이전 작업의 파일은 기존 단위를 그대로 유지하며, 리깅 및 애니메이션 USDZ 파일은 영향을 받지 않습니다.

Oct 10

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

Oct 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도 포함됩니다.
  • 다색 프린트는 3MF에 일치하는 슬라이서 프리셋을 기록하는 새로운 printer_brand 파라미터를 지원하며, 이를 통해 Bambu Lab(기본값)뿐만 아니라 Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker, AnkerMake 프린터에서도 바로 인쇄할 수 있는 상태로 파일이 열립니다. 이 페이지에는 이제 max_depth도 문서화되어 있습니다.

9월 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크레딧이 추가로 소요됩니다.

9월 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 Keys 페이지에서 발급받은 본인의 키로 교체하세요. 이 키는 입력과 관계없이 항상 동일한 샘플 모델을 반환했기 때문에 실제 요청이 무엇을 생성하는지 보여주지 못했습니다. 구현하기 전에 API가 무엇을 반환하는지 확인하려면 Developer Platform의 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가 추가되었습니다: 두 단계에 걸쳐 사진을 멀티컬러 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과, Meshy가 렌더링할 수 있는 경우 미리보기용 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로 마이그레이션하세요.

2026년 8월

Aug 28

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

Aug 26

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

Aug 24

  • gpt-image-2의 텍스트로 이미지 및 이미지로 이미지 API에서 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 프로토타입 엔드포인트에 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보다 더 높은 충실도의 지오메트리를 제공하는 Meshy의 최신 3D 생성 모델입니다. 또한 더욱 정교한 표면 디테일을 위한 Ultra 생성을 활성화하는 ultra_mode 파라미터를 새롭게 도입했습니다.
  • 멀티 이미지로 3D API에 ai_model: "meshy-7"가 추가되었습니다: 입력된 모든 뷰를 함께 조건으로 사용하여 텍스처링을 수행하는 Meshy의 멀티뷰 생성 모델입니다.
  • 리텍스처 API에 ai_model: "meshy-7"가 추가되었습니다: Meshy 6보다 더 선명한 표면 디테일과 더 깔끔한 PBR 머티리얼을 제공하는 Meshy의 최신 텍스처링 모델입니다. 또한 multiview_image_urls 파라미터를 새롭게 도입했습니다. 동일한 오브젝트에 대한 1개에서 4개의 순서가 지정된 뷰를 제공하여 멀티뷰 텍스처링을 수행할 수 있습니다.

Aug 4

  • Analyze Printability 및 Repair Printability 엔드포인트에서 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 모델로 변환합니다. 전체 내역은 Pricing을 참고하세요.

Jul 22

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

Jul 21

  • 이제 Image to 3D, Multi-Image to 3D, Text to 3D Refine, Retexture 엔드포인트에서 새로운 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 문서 페이지: 코드를 작성하지 않고도 엔드포인트를 테스트해 볼 수 있는 대화형 콘솔로, 이후 이에 상응하는 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크레딧.

2026년 5월

5월 26일

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

5월 22일

  • Remesh API의 변환 및 크기 조정 기능이 이제 독립적인 Convert API 및 Resize API 엔드포인트로 제공됩니다. 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 상태일 때 방수성, 부피, 홀, 비매니폴드 에지 지표를 반환합니다. 무료이며 크레딧이 소모되지 않습니다.
  • 새로운 프린팅 가능성 복구 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

4월 14일

4월 12일

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

2026년 3월

Apr 2

  • 모든 엔드포인트(이미지로 3D, 텍스트로 3D, 리메시, 리텍스처)의 target_formats 파라미터에 3mf 포맷 지원이 추가되었습니다. 참고: 3MF는 선택적(opt-in) 기능이며 명시적으로 요청해야 합니다.
  • 새로운 다색 프린트 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

  • 더 깔끔한 폴리곤으로 최적화된 로우폴리 메시를 생성할 수 있도록 텍스트로 3D Preview API에 model_type 파라미터를 추가했습니다.

2026년 1월

Jan 27

  • 모든 API 엔드포인트에 대해 일반적인 HTTP 오류 코드(400, 401, 402, 404, 422, 429) 및 작업 실패 원인을 포함한 상세한 실패 모드 문서가 추가되었습니다. 이를 통해 개발자가 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가 기본값입니다.

Jan 19

Jan 12

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

December 2025

Dec 31

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

Dec 22

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

Dec 04

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

Nov 04

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

October 2025

Oct 28

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

Oct 20

  • 입력 모델 파일의 형식 변환만 지원하기 위해 Remesh API(리메시 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

Aug 13

2025년 7월

Jul 31

2025년 6월

Jun 25

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

Jun 19

Jun 17

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

Jun 10

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

May 2025

May 20

5월 15일

2025년 4월

4월 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크레딧으로 유지

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 모델로 구동되는 Legacy 텍스트로 3D 및 이미지로 3D API를 지원 중단했습니다.

Jan 07

December 2024

Dec 19

  • 리메시 API를 추가하여 사용자가 다른 Meshy API로 생성된 기존 3D 모델을 리메시하고 다양한 형식으로 내보낼 수 있게 되었습니다.
  • 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로 인코딩된 이미지를 지원합니다.