lowpoly sẽ ngừng hoạt động vào 30 thg 10, 2026. Hãy chuyển sang mô hình khác trước các ngày này để tránh lỗi yêu cầu.

Nhật ký thay đổi

Xem tất cả các tính năng và bản cập nhật mới nhất của Meshy API và các plugin.

Bạn muốn theo dõi trực tiếp? Các mục mới nhất cũng xuất hiện trên trang tổng quan Developer Platform.

Tháng 10 2026

Oct 12

  • Các tệp USDZ giờ đây sử dụng đơn vị mét, vì vậy các model sẽ mở ra với kích thước thực trong AR Quick Look, Reality Composer, Blender và các trình xem USD khác. Tệp usdz trong model_urls của các tác vụ Text to 3D, Image to 3D, Multi-Image to 3D, Retexture, Remesh, Convert, Resize và Auto Split giờ đây khai báo metersPerUnit = 1. Trước đây tệp này khai báo đơn vị foot (metersPerUnit = 0.3048) trong khi tọa độ của nó lại tính bằng mét, khiến model hiển thị ở mức 30.48% kích thước thực. Nếu bạn đang scale các tệp USDZ theo hệ số 3.28 để bù lại, hãy loại bỏ việc scale đó đối với các tác vụ được tạo kể từ ngày này trở đi. Các tệp của những tác vụ trước đó vẫn giữ nguyên đơn vị hiện tại, và các tệp USDZ của Rigging và Animation không bị ảnh hưởng.

Oct 10

  • meshy-5 đã bị ngừng hỗ trợ. Các yêu cầu gửi ai_model: "meshy-5" đến Text to 3D, Image to 3D, Multi-Image to 3D hoặc Retexture giờ sẽ trả về 400 kèm thông báo ai_model meshy-5 has been retired; use meshy-6-lite. Hãy chuyển sang dùng meshy-6-lite, vốn nhận cùng các tham số với cùng mức chi phí credit. Các mô hình bạn đã tạo trước đó bằng meshy-5 vẫn khả dụng, và việc refine một preview meshy-5 mà không đặt ai_model vẫn hoạt động bình thường.
  • .webp giờ đã được ghi nhận là định dạng ảnh đầu vào được hỗ trợ, cùng với .jpg, .jpeg và .png, trên Image to 3D, Multi-Image to 3D, Image to Image, Retexture (image_style_url) và Text to 3D Refine (texture_image_url). Định dạng này hoạt động với cả URL công khai và data URI (data:image/webp;base64,...). Các tích hợp hiện có không bị ảnh hưởng, và giá không thay đổi.
  • Get Balance giờ cũng trả về monthly_credits, permanent_credits và monthly_resets_at, nhờ đó bạn có thể biết được bao nhiêu số dư của mình sẽ hết hạn vào lần làm mới tiếp theo. balance tự nó không thay đổi.

Oct 6

  • Phân tích khả năng in và Sửa khả năng in giờ đây có thể kiểm tra độ dày thành theo kích thước bạn dự định in. Gửi printer_type, một kích thước in, hoặc cả hai: phân tích sẽ báo cáo các thành mỏng trong printability.thin_walls, và sửa sẽ làm dày chúng khi cần thiết, đồng thời có thể tái sử dụng máy in và kích thước của một tác vụ phân tích được truyền vào dưới dạng input_task_id. Các tích hợp không sử dụng các trường này sẽ hoạt động như trước, và Giá không thay đổi.

Tháng 9 năm 2026

Sep 29

  • Đường dẫn legacy /v2/text-to-3d (không có tiền tố /openapi) đã không dùng nữa. Đường dẫn này vẫn hoạt động bình thường trong thời gian hiện tại, nhưng sẽ bị loại bỏ trong một bản phát hành trong tương lai — hãy chuyển sang dùng /openapi/v2/text-to-3d, vốn nhận cùng một yêu cầu và trả về cùng một phản hồi. Các phản hồi trên đường dẫn legacy hiện có thêm header Deprecation và header Link trỏ đến đường dẫn mới.

Sep 28

  • Các phản hồi API hiện bao gồm các header giới hạn tốc độ, trong đó có Retry-After để cho bạn biết cần chờ bao lâu trước khi thử lại hoặc polling lần nữa.
  • In nhiều màu hiện chấp nhận một tham số printer_brand mới, tham số này sẽ ghi một preset phần mềm cắt lớp tương ứng vào tệp 3MF, nhờ đó tệp mở ra là đã sẵn sàng để in trên các máy in Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker và AnkerMake cũng như Bambu Lab (giá trị mặc định). Trang này hiện cũng đã mô tả max_depth.

Sep 18

  • Đã thêm meshy-7.1 làm giá trị ai_model cho Ảnh sang 3D, Nhiều ảnh sang 3D và Văn bản sang 3D: cùng tham số và chi phí tín dụng như meshy-7, chi tiết hình học cao hơn. latest giờ đây sẽ phân giải thành meshy-7.1; meshy-7 đã không dùng nữa nhưng vẫn hoạt động bình thường không đổi.
  • Đã thêm geometry_resolution (standard / 2k / 4k) vào các API trên, thay thế cho ultra_mode hiện đã không dùng nữa (ultra_mode: true vẫn hoạt động và tương đương với "2k"). 4k yêu cầu Meshy 7.1 (meshy-7.1 hoặc latest), không khả dụng trên Nhiều ảnh sang 3D, và tốn thêm 5 tín dụng giống như 2k.

Sep 16

  • Auto Split API giờ đây chấp nhận input_task_id đã có texture. Trước đây nó từ chối với mã 400, nghĩa là bạn phải tạo lại cùng một lưới lần thứ hai với should_texture: false chỉ để tách nó. Lưu ý về kết quả của việc tách: nó cắt hình học và xây dựng lại bề mặt của từng phần, vì vậy texture của đầu vào không được giữ lại và kết quả là một mô hình không có texture với một màu đồng nhất cho mỗi phần — điều này vốn đã đúng với mọi lần tách và không có gì thay đổi.
  • meshy-5 sẽ ngừng hoạt động vào ngày 10 tháng 10 năm 2026. Nó không còn được ghi nhận là một giá trị ai_model cho Văn bản sang 3D, Ảnh sang 3D, Nhiều ảnh sang 3D hoặc Tạo lại texture, và sau ngày 10 tháng 10, các yêu cầu gửi ai_model: "meshy-5" sẽ trả về lỗi.
  • khóa API chế độ thử nghiệm dùng chung đã ngừng hoạt động; các yêu cầu vẫn gửi khóa này giờ sẽ trả về 401 Unauthorized. Nếu bạn đã sao chép khóa này vào mã nguồn hoặc CI, hãy thay thế bằng khóa riêng của bạn từ trang API Keys. Khóa đó luôn trả về cùng một mô hình mẫu bất kể đầu vào, vì vậy nó không bao giờ cho thấy một yêu cầu thực sự sẽ tạo ra điều gì. Để xem API trả về gì trước khi xây dựng dựa trên nó, hãy sử dụng Playground trong Developer Platform, nơi chạy một tác vụ thực trong trình duyệt của bạn. Với các gói không có quyền truy cập API, nó sẽ chạy Ảnh sang 3D mà không cần khóa API và sử dụng tín dụng của tài khoản bạn như bất kỳ tác vụ nào khác.

Sep 15

  • Đã thêm gpt-image-2-5-flare và gpt-image-2-5-sunburst vào danh sách giá trị ai_model được tài liệu hóa cho các API Văn bản sang ảnh và Ảnh sang ảnh. Đây là các phiên bản OpenAI GPT Image 2.5, có giá tương đương gpt-image-2 (Văn bản sang ảnh: 9 tín dụng; Ảnh sang ảnh: 12 tín dụng).
  • Các ai_model GPT Image (gpt-image-2, gpt-image-2-5-flare, gpt-image-2-5-sunburst) hiện cũng hỗ trợ tỷ lệ khung hình 4:3 và 3:4 trên các API Văn bản sang ảnh và Ảnh sang ảnh, bên cạnh 1:1, 16:9, 9:16, 3:2, và 2:3.

Sep 14

  • Image to Image API giờ đây chấp nhận input_task_id — cho phép liên kết trực tiếp từ một tác vụ Văn bản sang ảnh hoặc Ảnh sang ảnh đã hoàn thành, thay vì phải sao chép URL đầu ra của nó vào reference_image_urls.

Sep 11

  • Thay đổi hành vi: DELETE trên một tác vụ đã ở trạng thái IN_PROGRESS giờ đây sẽ bị từ chối với lỗi 409 Conflict, và tác vụ vẫn tiếp tục chạy. Trước đây, thao tác này trả về 200 OK, dừng worker và loại bỏ kết quả — trong khi vẫn giữ nguyên tín dụng đã trừ, vì chỉ các tác vụ PENDING mới được hoàn tín dụng, do đó lệnh gọi này khiến bạn mất cả model lẫn tín dụng mà không có gì trong phản hồi cho biết điều đó. Nếu hệ thống tích hợp của bạn xóa tác vụ để hủy chúng, hãy lưu ý rằng một tác vụ đã được worker bắt đầu xử lý thì không thể hủy được: hãy chờ đến khi tác vụ ở trạng thái SUCCEEDED, FAILED hoặc CANCELED, rồi mới xóa. Các tác vụ PENDING vẫn được xóa và hoàn tín dụng chính xác như trước, và các tác vụ ở trạng thái cuối (terminal) vẫn được xóa như bình thường. Điều này áp dụng cho mọi nhóm tác vụ trong /openapi. Xem Lỗi.
  • Đã thêm meshy-6-lite vào danh sách giá trị ai_model được tài liệu hóa cho các API Văn bản sang 3D, Ảnh sang 3D, Nhiều ảnh sang 3D và Tạo lại texture. Đây là phiên bản kế thừa của meshy-5: cùng tham số, cùng chi phí tín dụng (5 cho lưới, 15 kèm texture, 10 cho mỗi lần tạo lại texture).
  • meshy-5 hiện đã không dùng nữa trên mọi API có hỗ trợ nó. Nó vẫn hoạt động bình thường và không có gì thay đổi về yêu cầu hay hóa đơn của bạn, nhưng nó sẽ ngừng chấp nhận lưu lượng mới trong một phiên bản phát hành tương lai — nếu hệ thống tích hợp của bạn đang gửi ai_model: "meshy-5", hãy chuyển sang dùng meshy-6-lite.

Sep 9

  • Auto Split API mới: Tách một mô hình Meshy 6 hoặc Meshy 7 chưa phủ texture thành các bộ phận có thể in riêng biệt — tự động, theo các bộ phận bạn đặt tên (by_parts), hoặc theo vùng màu (by_color) — với tùy chọn đầu nối mộng (mortise-and-tenon) và gia cố thành mỏng. Xuất mỗi bộ phận thành một đối tượng riêng ở định dạng glb, obj, fbx, usdz, blend, hoặc 3mf, dù đã lắp ráp hay được sắp xếp trên bàn in (layout). 10 tín dụng cho mỗi tác vụ.

Sep 7

  • Đã thêm tham số name_text vào giai đoạn tạo nguyên mẫu của Creative Lab Keychain API: khắc một tên tối đa 10 ký tự lên móc khóa, giống như tính năng cá nhân hóa mà ứng dụng web cung cấp. Giai đoạn build sẽ tự động kế thừa phần khắc chữ này, và đối tượng tác vụ nguyên mẫu giờ đây trả về name_text để bạn có thể xác nhận chính xác nội dung văn bản trước khi build. Lưu ý rằng name vẫn chỉ là nhãn hiển thị của tác vụ và không được khắc lên sản phẩm.

Sep 5

  • Đã thêm Creative Lab Fidget Pixel API: biến một bức ảnh thành bảng fidget pixel-art đa màu có thể in 3D qua hai giai đoạn. POST /prototype (6 tín dụng) chuyển ảnh thành hình ảnh pixel-art — truyền type là person hoặc other để chọn kiểu pixel hóa — và POST /build (30 tín dụng) lấy mẫu ảnh đó lên lưới 16 hoặc 32 và biến mỗi pixel thành một mảnh ghép square hoặc hex khớp nối với nhau, xuất ra dưới dạng một tệp 3MF gắn thẻ màu duy nhất để in nhiều sợi nhựa. Hình học của mảnh ghép có thể tùy chỉnh thông qua piece_size_mm, color_count, và piece_height_mm.

Sep 4

  • Đã thêm GET /openapi/v1/animations/library vào Thư viện hoạt hình: lấy về mọi hành động dựng sẵn mà API Hoạt hình chấp nhận — action_id, tên, danh mục, và một bản xem trước GIF động — kèm bộ lọc tìm kiếm và danh mục, giúp bạn tự xây dựng bộ chọn hành động của riêng mình thay vì phải đọc bảng tham chiếu. Miễn phí; không tiêu tốn tín dụng.
  • Đã thêm API Creative Lab Collapsible Fidget: biến một bức ảnh thành đồ chơi fidget có thể xếp gọn, in liền một khối, trong đó hình bóng của chủ thể trở thành các vòng tròn đồng tâm lồng vào nhau, có thể gập phẳng và kéo giãn ra lại, được in thành một khối duy nhất mà không cần lắp ráp. Một yêu cầu POST duy nhất đưa hình ảnh đi suốt quá trình cho đến khi ra mô hình hoàn chỉnh — không có cặp giai đoạn prototype/build và không có tham số hình học nào cần tinh chỉnh. Mỗi tác vụ tốn 6 tín dụng và trả về cả tệp STL có thể in lẫn tệp GLB để xem trước.

Sep 3

  • Giai đoạn prototype của Creative Lab Lamp API giờ đây trả về một mô hình 3D: POST /prototype chuyển hình ảnh ý tưởng thành một chao đèn rỗng dạng GLB, và đối tượng tác vụ prototype có thêm model_urls.glb và thumbnail_url bên cạnh image_urls. Giai đoạn build chỉ chạy bộ xử lý đèn trên mô hình đó và giờ đây tạo ra một chao đèn hở đáy có tấm đế dành cho bộ phận nguồn sáng. Giá thay đổi theo khối lượng công việc: prototype là 30 tín dụng và build là 6 tín dụng (trước đây là 6 và 30). Tham số text của prototype đã bị loại bỏ — image_url là bắt buộc.

Sep 2

  • Animation API giờ đây chấp nhận action_ids — áp dụng tối đa 10 hành động dựng sẵn cho một nhân vật có rig trong một yêu cầu duy nhất và nhận lại một tệp duy nhất chứa mỗi clip hoạt hình cho từng hành động, sẵn sàng để điều khiển từ một state machine trong game engine. Các clip giữ nguyên thứ tự bạn liệt kê và mang theo tên thư viện của hoạt hình. Chi phí 3 tín dụng cho mỗi hành động, và post_process được áp dụng cho tệp đã gộp. Xem Animation Library Reference để biết các id khả dụng và bảng giá.

Sep 1

  • Đã thêm tham số ultra_mode vào Multi-Image to 3D API: cho phép kích hoạt chế độ tạo Ultra trên ai_model meshy-7 (hoặc latest) để có hình học độ trung thực cao hơn với chi tiết bề mặt tinh xảo hơn, với chi phí thêm 5 tín dụng — cùng một quy trình Ultra mà Image to 3D API cung cấp, nay đã khả dụng với đầu vào đa góc nhìn.
  • Đã loại bỏ meshy-t1 khỏi các giá trị ai_model được ghi trong tài liệu cho model_type Smart Topology của Image to 3D API. Smart Topology giờ đây chỉ ghi nhận meshy-t2; các tích hợp mới nên sử dụng giá trị này thay thế. Meshy T1 dự kiến sẽ bị ngừng hỗ trợ — nếu tích hợp của bạn hiện đang gửi ai_model: "meshy-t1", hãy chuyển sang sử dụng meshy-t2.

August 2026

Aug 28

  • Đã thêm Usage API cho các nhóm Studio và Enterprise: xuất dữ liệu lịch sử sử dụng API task theo chương trình — endpoint, trạng thái, dấu thời gian, khóa API đã chạy mỗi task, và consumed_credits — với phân trang tiêu chuẩn cùng các bộ lọc theo khoảng thời gian, endpoint và trạng thái, phục vụ cho việc theo dõi chi phí và các hệ thống tài chính.

Aug 26

  • Animation API giờ đây chấp nhận motion_task_id — áp dụng một đoạn chuyển động được tạo bằng Text to Motion API lên nhân vật biped đã được rig của bạn, như một lựa chọn thay thế cho action_id được đặt sẵn. Vẫn là 3 tín dụng cho mỗi task.

Aug 24

  • Mở rộng hỗ trợ aspect_ratio cho gpt-image-2 trên các API Văn bản sang ảnh và Ảnh sang ảnh để thêm 16:9 và 9:16. gpt-image-2 giờ đây hỗ trợ 1:1, 16:9, 9:16, 3:2, và 2:3; 4:3 và 3:4 vẫn chưa được hỗ trợ cho model này.

Aug 21

  • Đã thêm Text to Motion API: tạo một đoạn clip chuyển động nhân vật từ mô tả bằng ngôn ngữ tự nhiên, không cần model nhân vật. Chọn mode prime (10 tín dụng, đầu ra FBX) để có chất lượng cao nhất hoặc mode swift (3 tín dụng, đầu ra BVH) để tạo nhanh, tiết kiệm, với thời lượng clip từ 2–10 giây.

Aug 20

  • Đã thêm tham số style vào Multi-Color Print API: chọn realistic (mặc định) để có màu sắc chính xác theo texture, hoặc cartoon để có các vùng màu phẳng, đồng nhất và file 3MF nhỏ hơn.
  • Đã thêm tham số remove_background vào mọi endpoint prototype của Creative Lab — Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet và Lamp. Đặt remove_background: true để nhận hình ảnh prototype dưới dạng PNG RGBA trong suốt với nền đã được xóa.

Aug 18

  • Đã thêm tham số texture_image_urls vào API Nhiều ảnh sang 3D: cung cấp 1–4 ảnh của cùng một đối tượng để định hướng việc tạo texture, thay vì chỉ dùng một texture_image_url duy nhất. Yêu cầu ai_model là meshy-7 hoặc latest, và độc lập với image_urls — hai danh sách này có thể chứa các ảnh khác nhau và số lượng ảnh khác nhau.

Aug 17

  • Đã thêm tham số remove_background vào API Văn bản sang ảnh và API Ảnh sang ảnh. Đặt remove_background: true để nhận ảnh được tạo dưới dạng PNG RGBA trong suốt với nền đã được xóa.

Aug 13

  • Đã thêm ai_model: "meshy-7" vào Text to 3D API: mô hình tạo 3D mới nhất của chúng tôi, với hình học có độ chân thực cao hơn Meshy 6. Nó cũng giới thiệu tham số ultra_mode trên tác vụ xem trước (preview task), cho phép bật chế độ tạo Ultra để có chi tiết bề mặt tinh xảo hơn với chi phí 5 tín dụng bổ sung. Để lên texture với Meshy 7, hãy truyền ai_model: "meshy-7" trên tác vụ refine hoặc bỏ qua hoàn toàn ai_model.
  • Đã thêm model_type Smart Topology vào Text to 3D API. Đặt model_type: "smart-topology" để tạo bằng meshy-t2 — topology sạch hơn, các bộ phận được tách biệt một cách tự nhiên, xuất dạng tam giác, và số lượng mặt có thể thiết lập bằng target_polycount (từ 100 đến 15.000, mặc định là 4.000). Một preview Smart Topology tốn 5 tín dụng thay vì 20; xem Giá. model_type: "lowpoly" hiện có không dùng nữa nhưng vẫn tiếp tục phục vụ lưu lượng truy cập để đảm bảo khả năng tương thích ngược.

Aug 12

  • Đã thêm ai_model: "meshy-7" vào Image to 3D API: mô hình tạo 3D mới nhất của chúng tôi, với hình học có độ chân thực cao hơn Meshy 6. Mô hình này cũng giới thiệu tham số ultra_mode, cho phép kích hoạt chế độ tạo Ultra để có chi tiết bề mặt tinh xảo hơn nữa.
  • Đã thêm ai_model: "meshy-7" vào Multi-Image to 3D API: mô hình tạo đa góc nhìn của Meshy, mô hình này dựa trên tất cả các góc nhìn đầu vào của bạn cùng lúc và sử dụng chúng để dẫn dắt quá trình tạo texture.
  • Đã thêm ai_model: "meshy-7" vào Retexture API: mô hình tạo texture mới nhất của chúng tôi, với chi tiết bề mặt sắc nét hơn và vật liệu PBR rõ ràng hơn so với Meshy 6. Mô hình này cũng giới thiệu tham số multiview_image_urls — cung cấp 1–4 góc nhìn có thứ tự của cùng một đối tượng để dẫn dắt quá trình tạo texture đa góc nhìn.

Aug 4

  • Mở rộng hỗ trợ đầu vào model_url sang .glb, .gltf, .obj, .fbx, .stl cho các endpoint Phân tích khả năng in và Sửa khả năng in (trước đây là .glb, .stl, .obj). Sửa khả năng in trả về asset đã sửa theo đúng định dạng đầu vào.

July 2026

Jul 27

  • Mới Creative Lab — Brick Figure API: biến một bức ảnh thành một mô hình 3D minifigure dạng gạch có thể sưu tầm. Cùng quy trình hai giai đoạn như Figure API — prototype (6 tín dụng) tạo ra một hình ảnh concept theo phong cách đã chọn, build (30 tín dụng) biến nó thành một mô hình 3D có texture với đầu ra GLB và OBJ + MTL. Xem Giá để biết chi tiết đầy đủ.

Jul 22

  • Mới Creative Lab — Keycap API: biến một bức ảnh thành bàn phím cơ tùy chỉnh với keycap toàn màu. Quy trình hai giai đoạn — prototype (12 tín dụng) tạo bản render thiết kế keycap hoàn chỉnh, sau đó build (50 tín dụng) biến thiết kế bạn chọn (thông qua candidate_id) thành mô hình keycap 3D có texture với đầu ra dạng gói GLB và OBJ, được xuất theo tỷ lệ milimét đúng kích thước thực tế. Hiện tại hỗ trợ đế Cherry MX 1u tiêu chuẩn (cherry-mx-1x1-r1); nhiều kích thước tiêu chuẩn khác đang được lên kế hoạch bổ sung. Xem Giá để biết chi tiết đầy đủ.

Jul 21

  • Hiện chúng tôi hỗ trợ texture màu nền 8K thông qua tham số texture_resolution mới (2k / 4k / 8k) trên các endpoint Ảnh sang 3D, Nhiều ảnh sang 3D, Refine Văn bản sang 3D, và Tạo lại texture. Ở mức 8k, bản đồ PBR được tạo ở độ phân giải 4K và không có bản đồ phát xạ (emission map) nào được tạo ra. Việc tạo texture 8K tốn 15 tín dụng (2k/4k vẫn giữ nguyên 10). Xem Giá.
  • Tham số boolean hd_texture không dùng nữa, được thay thế bằng texture_resolution — nó vẫn được hỗ trợ và tương đương với texture_resolution: "4k" để đảm bảo khả năng tương thích ngược.

Jul 20

  • Mới Creative Lab — Vinyl Figure API: biến một bức ảnh thành một tượng sưu tầm 3D vinyl đầu to. Quy trình làm việc hai giai đoạn giống như Figure API — prototype (6 tín dụng) tạo ra một hình ảnh khái niệm có phong cách, build (30 tín dụng) biến nó thành một mô hình 3D có texture với đầu ra GLB và OBJ + MTL. Xem Giá để biết chi tiết đầy đủ.

Jul 13

  • Đã thêm một model_type Smart Topology mới vào API Ảnh sang 3D, cung cấp hai mô hình thông qua ai_model: meshy-t1 — mô hình low-poly hiện tại — và meshy-t2 — một mô hình mới với topology sạch hơn, các bộ phận được tách riêng một cách tự nhiên, đầu ra dạng tam giác, và số lượng mặt có thể thiết lập bằng target_polycount. meshy-t2 là mặc định trong smart-topology. model_type: lowpoly hiện có giờ đây không dùng nữa nhưng vẫn tiếp tục phục vụ lưu lượng truy cập để đảm bảo khả năng tương thích ngược.

Jul 7

  • Đã thêm tham số aspect_ratio vào API Ảnh sang ảnh, giúp bạn kiểm soát tỷ lệ ảnh đầu ra khi chỉnh sửa. Các giá trị được phép là 1:1, 16:9, 9:16, 4:3, 3:4 cho các mô hình nano-banana và 1:1, 3:2, 2:3 cho gpt-image-2. Không bắt buộc; mặc định là 1:1, và không thể kết hợp với generate_multi_view.

June 2026

Jun 17

  • Trang tài liệu API Playground mới: một bảng điều khiển tương tác để thử nghiệm các endpoint mà không cần viết mã, sau đó sao chép đoạn cURL, Python hoặc JavaScript tương ứng. Có sẵn trên các gói Pro, Premium, Ultra, Studio và Enterprise.

Jun 15

  • Mới UV Unwrap API: tạo bố cục UV chất lượng cao cho một mô hình 3D có sẵn — bước tiên quyết trước khi tạo texture, hoặc bất cứ khi nào bạn cần một bố cục UV sạch, không chồng lấn để dùng cho các công cụ ở các bước sau. Nhận vào input_task_id (một tác vụ Ảnh sang 3D, Văn bản sang 3D, hoặc Remesh đã hoàn tất) hoặc model_url (chỉ .glb) và trả về một "mô hình trắng UV" với tọa độ UV hoàn toàn mới. 5 tín dụng mỗi lần gọi. Hỗ trợ mesh lên đến 40.000 mặt (chạy Remesh trước nếu lớn hơn); các mesh dạng tứ giác và đa giác sẽ được tam giác hóa trong quá trình tạo UV.

Jun 12

  • Đã cập nhật giá Build của Creative Lab API lên 30 tín dụng cho mỗi lần gọi đối với Keychain, Fridge Magnet, và Figure (trước đó là 20). Lamp không thay đổi, vẫn là 30 tín dụng. Giá Prototype không thay đổi, vẫn là 6 tín dụng cho mỗi ảnh. Xem Pricing để biết chi tiết đầy đủ.

Jun 5

  • Đã thêm tham số tùy chọn alpha_thumbnail vào các API Image to 3D, Multi-Image to 3D, Text to 3D, Retexture, Remesh, và Repair Printability. Khi đặt thành true, tác vụ sẽ render thêm một phiên bản xem trước có nền trong suốt (RGBA) và trả về dưới trường phản hồi mới alpha_thumbnail_url. Trường thumbnail_url hiện có không thay đổi. Giá trị mặc định là false.

Jun 1

  • Creative Lab APIs mới: một nhóm các endpoint theo từng sản phẩm, biến một ảnh nguồn (hoặc prompt văn bản) thành một sản phẩm tiêu dùng có thể in 3D. Bốn sản phẩm ra mắt lần đầu — Keychain (móc khóa), Fridge Magnet (nam châm tủ lạnh), Figure (tượng), và Lamp (đèn). Mỗi sản phẩm tuân theo quy trình hai giai đoạn prototype → build được liên kết thông qua input_task_id, phục vụ dưới các URL theo từng sản phẩm (/openapi/creative-lab/<product>/v1/...) với việc đánh phiên bản riêng cho từng sản phẩm để các sản phẩm có thể phát triển trên các dòng phiên bản độc lập. Prototype: 6 tín dụng mỗi lần gọi. Build: 30 tín dụng mỗi lần gọi.

Tháng 5 2026

May 26

  • Đã thêm tham số multi_view_thumbnails vào API Nhiều ảnh sang 3D. Khi được đặt thành true, tác vụ sẽ render thêm bốn ảnh thu nhỏ theo bốn hướng chính (trước, phải, sau, trái) và trả về chúng trong trường phản hồi mới thumbnail_urls. Trường thumbnail_url hiện có vẫn không thay đổi. Việc này làm tăng độ trễ tác vụ thêm khoảng 3 giây.

May 22

  • Chức năng chuyển đổi và đổi kích thước từ Remesh API hiện đã có sẵn dưới dạng các endpoint độc lập Convert API và Resize API. Các tham số không dùng nữa trên Remesh sẽ tiếp tục hoạt động để đảm bảo khả năng tương thích ngược.

13 tháng 5

  • Đã thêm tham số multi_view_thumbnails vào API Ảnh sang 3D. Khi được đặt thành true, tác vụ sẽ render thêm bốn ảnh thu nhỏ theo bốn hướng chính (trước, phải, sau, trái) và trả về chúng trong trường phản hồi mới thumbnail_urls. Trường thumbnail_url hiện có vẫn giữ nguyên không thay đổi. Việc này làm tăng thêm khoảng 3 giây độ trễ của tác vụ.

12 tháng 5

  • Đã thêm tham số resize_longest_side vào API Remesh. Thay đổi kích thước mô hình sao cho chiều dài nhất của hộp giới hạn bằng giá trị được chỉ định tính bằng mét. Không thể sử dụng đồng thời với resize_height và auto_size.

May 11

May 7

  • Analyze Printability API mới: Phân tích khả năng in của một tác vụ Meshy đã thành công — hoặc bất kỳ URL mô hình 3D nào — cho khả năng sẵn sàng in 3D FDM. Mẫu hình tạo bất đồng bộ + truyền trực tuyến: POST trả về một task_id, sau đó GET / luồng SSE trả về các số liệu về tính kín nước, thể tích, lỗ hổng và cạnh non-manifold khi đạt trạng thái SUCCEEDED. Miễn phí, không tiêu tốn tín dụng.
  • Repair Printability API mới: Sửa khả năng in của một mô hình 3D cho in 3D FDM — khắc phục cạnh non-manifold, mặt suy biến, lỗ hổng và các vấn đề topology khác. Chấp nhận một input_task_id Meshy hiện có hoặc một model_url (.glb, .stl, .obj). Định dạng đầu ra khớp với định dạng đầu vào. 10 tín dụng cho mỗi tác vụ.

Tháng 4 2026

Apr 27

  • Đã thêm trường consumed_credits vào mọi phản hồi tác vụ trên tất cả các endpoint API. Hiển thị số lượng tín dụng mà mỗi tác vụ đã tiêu thụ. Trường này xuất hiện đối với các tác vụ ở trạng thái PENDING, IN_PROGRESS, và SUCCEEDED. Trả về 0 đối với các tác vụ FAILED (tín dụng sẽ tự động được hoàn lại khi thất bại). Xem Giá để biết chi phí tín dụng cho từng endpoint.

Apr 24

  • Đã thêm tham số model_url vào endpoint In nhiều màu. Gửi trực tiếp một mô hình 3D đã có texture (qua URL hoặc Data URI) thay vì dùng input_task_id từ một tác vụ Meshy trước đó. Các định dạng được hỗ trợ: .glb, .fbx. Khi cả model_url và input_task_id đều được cung cấp, input_task_id sẽ được ưu tiên.

Apr 21

  • Đã thêm tham số input_task_id vào các endpoint Ảnh sang 3D và Nhiều ảnh sang 3D. Tham chiếu trực tiếp đầu ra của một tác vụ Văn bản sang ảnh hoặc Ảnh sang ảnh đã hoàn thành thay vì cung cấp image_url / image_urls. Khi cả hai đều được cung cấp, input_task_id sẽ được ưu tiên.

Apr 20

Apr 14

Apr 12

  • Tái cấu trúc tài liệu API: thêm nhóm tham số với các trường phụ thuộc, giá trị mặc định nội tuyến, nhãn bắt buộc/không dùng nữa, điều hướng con có thể mở rộng, và tách Nhiều ảnh, Rigging, và Hoạt hình thành các trang riêng biệt.

Tháng 3 năm 2026

Apr 2

  • Đã thêm hỗ trợ định dạng 3mf cho tham số target_formats trên tất cả các endpoint (Ảnh sang 3D, Văn bản sang 3D, Remesh, Tạo lại texture). Lưu ý: 3MF chỉ được áp dụng khi được yêu cầu rõ ràng (opt-in).
  • API mới Multi-Color Print: Chuyển đổi mô hình 3D sang định dạng 3MF in nhiều màu để in 3D. Hỗ trợ bảng màu từ 1-16 màu với độ chính xác có thể cấu hình. 10 tín dụng cho mỗi tác vụ.

Mar 20

  • Đã ngừng hỗ trợ mô hình AI Meshy-4. Tất cả các yêu cầu API sử dụng meshy-4 không còn được hỗ trợ nữa. Vui lòng chuyển sang sử dụng meshy-6 hoặc latest.
  • Đã thêm các tham số auto_size và origin_at vào các endpoint Ảnh sang 3D, Nhiều ảnh sang 3D, Văn bản sang 3D, và Remesh. Khi auto_size được bật, dịch vụ sẽ sử dụng AI vision để ước tính chiều cao thực tế và tự động đổi kích thước mô hình. origin_at thiết lập vị trí gốc tọa độ (bottom hoặc center). Trong API Remesh, auto_size loại trừ lẫn nhau với resize_height.

Mar 17

February 2026

Feb 28

Feb 25

  • Đã thêm tham số image_enhancement vào các API Ảnh sang 3D và Nhiều ảnh sang 3D dành cho người dùng muốn từ chối tối ưu hóa ảnh đầu vào và giữ nguyên hình dáng chính xác của ảnh đầu vào của họ. Chỉ được hỗ trợ cho meshy-6 và latest. Mặc định là true.

Feb 20

  • Đã thêm tham số model_type vào API Xem trước Văn bản sang 3D để tạo lưới low-poly được tối ưu hóa cho các đa giác gọn gàng hơn.

Tháng 1 năm 2026

Jan 27

  • Đã bổ sung tài liệu chi tiết về Failure Modes cho tất cả các Endpoint API, bao gồm các mã lỗi HTTP phổ biến (400, 401, 402, 404, 422, 429) và các nguyên nhân tác vụ thất bại. Điều này giúp các nhà phát triển hiểu rõ hơn và xử lý lỗi API tốt hơn.

Jan 26

  • API Nhiều ảnh sang 3D hiện đã hỗ trợ Meshy-6 cho tạo lưới đầy đủ. Tham số ai_model giờ đây chấp nhận meshy-6 và latest sẽ phân giải thành Meshy 6.

Jan 22

  • Đã đánh dấu không dùng nữa đối với art_style cho API Văn bản sang 3D Preview (Meshy-6). Tham số này được thiết kế cho các model Legacy (Meshy-4 / Meshy-5) và sẽ bị loại bỏ trong một bản phát hành trong tương lai.
  • Đã đánh dấu không dùng nữa đối với enable_pbr cho các API Văn bản sang 3D và Ảnh sang 3D khi ai_model là meshy-4. Tham số này sẽ bị loại bỏ trong một bản phát hành trong tương lai.
  • Đã cập nhật giá trị mặc định của tham số should_remesh cho Meshy-6 trong các API Văn bản sang 3D và Ảnh sang 3D. Tham số này giờ đây mặc định là false đối với meshy-6, và true đối với các model khác nếu không được chỉ định.

Jan 19

Jan 12

  • Đã thêm tham số model_type mới vào API Ảnh sang 3D để tạo các mesh low-poly được tối ưu hóa cho các đa giác gọn gàng hơn.

Tháng 12 năm 2025

Dec 31

  • Ra mắt API Playground, một không gian riêng dành cho các nhà phát triển để khám phá các tham số API và thử nghiệm các yêu cầu trực tiếp trên trang web Meshy.
  • Giới thiệu API Văn bản sang ảnh và API Ảnh sang ảnh, cho phép tạo ảnh bằng AI từ các câu lệnh văn bản và chỉnh sửa ảnh từ các ảnh tham chiếu. Cả hai API đều hỗ trợ các mô hình nano-banana và nano-banana-pro, với tùy chọn tạo Đa góc nhìn.

Dec 22

  • Trường video_url trong phản hồi API Văn bản sang 3D hiện không dùng nữa và sẽ bị loại bỏ trong một phiên bản phát hành trong tương lai.

Dec 04

  • Đã thêm tham số pose_mode mới vào các API Text to 3D Preview, Ảnh sang 3D, và Nhiều ảnh sang 3D. Tham số này chấp nhận a-pose, t-pose, hoặc một chuỗi rỗng (mặc định). Tham số is_a_t_pose hiện không dùng nữa và được thay thế bằng pose_mode.

Tháng 11 năm 2025

Nov 24

  • API Ảnh sang 3D và Nhiều ảnh sang 3D bổ sung tham số tùy chọn save_pre_remeshed_model và hiển thị model_urls.pre_remeshed_glb khi có yêu cầu sao lưu trước khi remesh.

Nov 06

  • API Văn bản sang 3D Refine giờ đây hỗ trợ ai_model = latest, phân giải thành Meshy 6 Preview.
  • API Ảnh sang 3D giờ đây mặc định sử dụng tạo texture Meshy-6-preview khi ai_model = latest và should_texture = true.
  • API Nhiều ảnh sang 3D giờ đây hỗ trợ ai_model = latest, chạy Meshy-6-preview để tạo texture theo mặc định trong khi việc tạo lưới vẫn sử dụng Meshy-5.
  • API Tạo lại texture bổ sung tùy chọn latest cho ai_model (Meshy-6-preview) và giờ đây sẽ mặc định sử dụng tùy chọn này khi không được chỉ định.

Nov 04

  • Remesh API hiện giữ nguyên texture cho các mô hình đã tải lên.
  • API Tạo lại texture hiện giữ nguyên texture cho các mô hình đã tải lên khi tùy chọn enable_original_uv được bật.

Tháng 10 năm 2025

Oct 28

  • Đã thêm tiêu đề phản hồi x-api-version để chỉ ra phiên bản máy chủ API hiện tại.

Oct 20

  • Đã thêm tham số boolean tùy chọn convert_format_only vào Remesh API để hỗ trợ chỉ chuyển đổi định dạng của tệp mô hình đầu vào.
  • Đã thêm rigged_character_glb_url vào phản hồi của The Rigging Task Object.

Oct 01

  • Xóa các API text-to-voxel

Tháng 9 năm 2025

Sep 23

  • Đã thêm tùy chọn latest cho ai_model trong API Văn bản sang 3D để sử dụng Meshy 6 Preview.
  • Áp dụng giảm giá tạm thời 50% cho các tác vụ tạo bằng Meshy-6-preview xuống còn 10 tín dụng, kéo dài đến hết ngày 30 tháng 9 năm 2025. Sau thời gian giảm giá, chi phí cho các tác vụ Meshy-6-preview sẽ trở về mức bình thường là 20 tín dụng.

Sep 18

Sep 16

  • Đã thêm tùy chọn latest cho ai_model trong API Ảnh sang 3D để sử dụng Meshy 6 Preview.

Sep 4

August 2025

Aug 18

Aug 13

  • Meshy 5 hiện đã ổn định cho Văn bản sang 3D và Ảnh sang 3D (ai_model: meshy-5), mang lại chất lượng và tính nhất quán được cải thiện.

Tháng 7 2025

Jul 31

Tháng 6 2025

Jun 25

  • Đã thêm Retexture API, cho phép người dùng tạo lại texture cho các mô hình 3D dựa trên các ai_model nền tảng mới nhất của Meshy.

Jun 19

Jun 17

Jun 10

  • API Remesh hiện đã hỗ trợ các mô hình GLB mã hóa base64 trong tham số model_url thông qua Data URI.

Tháng 5 2025

May 20

May 15

Tháng 4 năm 2025

Apr 29

  • Đã giới thiệu Multi-Image to 3D API, cho phép tạo mô hình 3D từ 1 đến 4 ảnh đầu vào bằng mô hình AI meshy-5.
  • Đã thêm tùy chọn mô hình AI meshy-5 vào các API Text to 3D và Image to 3D. Thẻ latest giờ đây cũng trỏ đến meshy-5.

Apr 17

  • Đã thêm tham số texture_image_url vào các API Ảnh sang 3D và Văn bản sang 3D Refine, cho phép người dùng định hướng quá trình tạo texture bằng một hình ảnh.

March 2025

Mar 28

  • Đã thêm tham số latest vào các API Văn bản sang 3D và Ảnh sang 3D, cho phép truy cập vào các mô hình AI tiên tiến sắp ra mắt của chúng tôi để cải thiện chất lượng tạo mô hình.

Mar 14

Mar 06

  • Cập nhật giá cho các tác vụ tạo qua API:
    • Văn bản sang 3D (Preview): Tăng từ 2 lên 5 tín dụng mỗi lần gọi
    • Văn bản sang 3D (Refine): Tăng từ 5 lên 10 tín dụng mỗi lần gọi
    • Ảnh sang 3D: Hiện là 5 tín dụng nếu không có texture, 15 tín dụng nếu có texture
    • Văn bản sang texture: Tăng từ 5 lên 10 tín dụng mỗi lần gọi
    • Text to Voxel: Vẫn giữ nguyên 5 tín dụng mỗi lần gọi

Tháng 2 năm 2025

Feb 18

  • Đã thêm khóa API chế độ thử nghiệm cho phép các nhà phát triển kiểm tra tích hợp API mà không tiêu tốn tín dụng. Tất cả các yêu cầu hợp lệ sử dụng khóa này sẽ trả về cùng một kết quả tác vụ mẫu.

Feb 13

  • Thay đổi quan trọng:

    • Việc tạo tác vụ ở gói miễn phí sẽ kết thúc vào ngày March 20, 2025. Sau thời điểm đó, tất cả các yêu cầu tác vụ API sẽ yêu cầu phải có đăng ký trả phí. Để duy trì quyền truy cập thông suốt, chúng tôi khuyên bạn nên nâng cấp trước hạn chót.
    • Sử dụng mã giảm giá APIACCESS để được hưởng ưu đãi giảm 40%. Cảm ơn bạn đã đồng hành cùng chúng tôi!

  • Đã thêm các endpoint truyền trực tuyến Server-Sent Events (SSE) để cập nhật tác vụ theo thời gian thực:

Feb 6

  • Đã thêm tham số texture_prompt vào các API Ảnh sang 3D và Text to 3D Refine, cho phép người dùng định hướng quá trình tạo texture bằng một prompt văn bản.

Tháng 1 2025

Jan 23

Jan 14

  • Đã ngừng sử dụng các API Văn bản sang 3D và Ảnh sang 3D cũ (legacy) được vận hành bởi các mô hình AI Meshy-3.

Jan 07

Tháng 12 năm 2024

Dec 19

  • Đã thêm các API Remesh, cho phép người dùng thực hiện remesh và xuất các mô hình 3D hiện có được tạo bởi các API khác của Meshy sang nhiều định dạng khác nhau.
  • Đã cập nhật giới hạn số đa giác cho các API của chúng tôi lên phạm vi 100-300.000 cho người dùng Premium.

Dec 12

  • Đã không dùng nữa thuộc tính model_url trong tất cả các đối tượng phản hồi.
  • Tách API Meshy-3 cũ (legacy) khỏi API Meshy-4 mới nhất.

Dec 10

Dec 5

Dec 3

  • Các API bên ngoài hiện sử dụng tiền tố /openapi. Các đường dẫn Legacy vẫn được hỗ trợ, nhưng chúng tôi khuyến nghị chuyển sang các đường dẫn mới.

Tháng 11 2024

Nov 14