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.

Muốn xem dạng bảng tin 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 9 năm 2026

Sep 18

  • Đã thêm meshy-7.1 như một giá trị ai_model cho Ảnh sang 3D, Nhiều ảnh sang 3D và Văn bản sang 3D: thông số và chi phí tín dụng giố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 như trước.
  • Đã thêm geometry_resolution (standard / 2k / 4k) vào các API tương tự, 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à có chi phí bằng với 2k là thêm 5 tín dụng.

Sep 16

  • Auto Split API giờ đây chấp nhận input_task_id đã có texture. Trước đây, API này sẽ 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ả trả về khi tách: quá trình này cắt hình học và dựng lại bề mặt của từng phần, do đó texture của đầu vào không được giữ lại và kết quả là một mô hình chưa có texture với một màu phẳng 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 đã ngừng hoạt động. Giá trị này không còn khả dụng như 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. Nếu tích hợp của bạn gửi ai_model: "meshy-5", hãy chuyển sang meshy-6-lite — nó nhận cùng các tham số và có chi phí như nhau.

Sep 15

  • Đã thêm gpt-image-2-5-flare và gpt-image-2-5-sunburst vào các giá trị ai_model được tài liệu hóa cho API Văn bản sang ảnh và Ảnh sang ảnh. Đây là các gói OpenAI GPT Image 2.5, có giá tương đương với gpt-image-2 (Văn bản sang ảnh: 9 tín dụng; Ảnh sang ảnh: 12 tín dụng).
  • Các mô hình GPT Image (gpt-image-2, gpt-image-2-5-flare, gpt-image-2-5-sunburst) giờ đây cũng hỗ trợ các tỷ lệ khung hình 4:3 và 3:4 trên 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 nối tiếp 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 mã 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 số tín dụng đã trừ, vì chỉ những tác vụ ở trạng thái PENDING mới được hoàn tín dụng, khiến bạn vừa mất mô hình vừa mất tín dụng mà không có bất kỳ thông báo nào trong phản hồi. Nếu hệ thống tích hợp của bạn xóa tác vụ nhằm mục đích hủy chúng, hãy lưu ý rằng một tác vụ mà worker đã bắt đầu xử lý thì không thể hủy được: hãy chờ đến khi tác vụ đạt trạng thái SUCCEEDED, FAILED hoặc CANCELED, rồi mới xóa. Các tác vụ ở trạng thái PENDING vẫn được xóa và hoàn tín dụng như trước, và các tác vụ đã ở trạng thái cuối cùng vẫn được xóa bình thường. Á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ế nhiệm 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 việc tạo lại texture).
  • meshy-5 hiện đã không dùng nữa trên tất cả các API chấp nhận giá trị này. 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 truy cập mới trong một bản phát hành trong tương lai — nếu hệ thống tích hợp của bạn gửi ai_model: "meshy-5", hãy chuyển sang sử dụng meshy-6-lite.

Sep 9

  • Auto Split API mới: Chia một mô hình Meshy 6 hoặc Meshy 7 chưa có 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 đầu nối mộng (mortise-and-tenon) và gia cố thành mỏng tùy chọn. 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ưới dạng đã lắp ráp hoặc đượ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 mẫu thử (prototype) của Creative Lab Keychain API: khắc một tên tối đa 10 ký tự lên móc khóa, cùng 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 nội dung khắc, và đối tượng tác vụ tạo mẫu thử giờ đây trả về name_text để bạn có thể xác nhận chính xác nội dung trước khi build. Lưu ý rằng name vẫn chỉ là nhãn hiển thị cho 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 một bảng fidget pixel-art đa màu có thể in 3D theo hai giai đoạn. POST /prototype (6 tín dụng) pixel hóa bức ả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 liên kết dạng square hoặc hex, xuất ra dưới dạng một tệp 3MF gắn nhãn màu duy nhất để in đa sợi. 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à Animation API 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 Creative Lab Collapsible Fidget API: biến một bức ảnh thành một món đồ chơi fidget có thể gập lại và in liền khối, trong đó bóng dá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 lại rồi kéo dãn ra, được in liền một khối mà không cần lắp ráp. Một lệnh 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 điều chỉnh. Mỗi tác vụ tốn 6 tín dụng và trả về cả một file STL có thể in được lẫn một file 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 đổi hình ảnh concept thành GLB chao đèn rỗng, 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ờ tạo ra một chao đèn hở đáy kèm tấm đế cho phần gắ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 giờ là bắt buộc.

Sep 2

  • API Hoạt hình giờ đây hỗ trợ 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 về một tệp duy nhất chứa mỗi hành động là một đoạn hoạt hình, sẵn sàng để điều khiển từ một state machine trong game engine. Các đoạn hoạt hình sẽ giữ đúng 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 sẽ áp dụng cho tệp đã được gộp. Xem Tài liệu tham khảo Thư viện hoạt hình để biết các id khả dụng và bảng giá.

Sep 1

  • Đã thêm tham số ultra_mode vào API Nhiều ảnh sang 3D: cho phép kích hoạt chế độ tạo Ultra trên ai_model meshy-7 (hoặc latest) để tạo ra hình học có độ trung thực cao hơn với chi tiết bề mặt tinh tế hơn, với chi phí thêm 5 tín dụng — cùng một quy trình Ultra mà API Ảnh sang 3D 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 API Ảnh sang 3D. Smart Topology hiện 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ẽ 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.

Tháng 8 năm 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 tác vụ API theo phương thức lập trình — endpoint, trạng thái, dấu thời gian, khóa API đã chạy mỗi tác vụ, 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 hai chân đã gắn rig của bạn, như một lựa chọn thay thế cho action_id được thiết lập sẵn. Vẫn giữ nguyên mức 3 tín dụng cho mỗi tác vụ.

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 chấp nhận 1:1, 16:9, 9:16, 3:2, và 2:3; 4:3 và 3:4 vẫn không được hỗ trợ đối với model này.

Aug 21

  • Đã thêm API Văn bản sang chuyển động: tạo đ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 và 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à tệp 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 Multi-Image to 3D API: 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 texture_image_url đơn lẻ. 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 Text to Image API và Image to Image API. Đặt remove_background: true để nhận ảnh được tạo ra dưới dạng PNG RGBA trong suốt với phần nền đã được loại bỏ.

Aug 13

  • Đã thêm ai_model: "meshy-7" vào API Văn bản sang 3D: mô hình tạo 3D mới nhất của chúng tôi, với hình học có độ chính xác cao hơn so với Meshy 6. Nó cũng giới thiệu tham số ultra_mode trên tác vụ preview, cho phép kích hoạt chế độ tạo Ultra để có chi tiết bề mặt tinh xảo hơn với 5 tín dụng phụ thêm. Để tạo texture với Meshy 7, hãy truyền ai_model: "meshy-7" trên tác vụ refine hoặc bỏ hoàn toàn ai_model.
  • Đã thêm model_type Smart Topology vào API Văn bản sang 3D. Đặt model_type: "smart-topology" để tạo bằng meshy-t2 — topology gọn gàng 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 (từ 100 đến 15.000, mặc định là 4.000). Một tác vụ preview Smart Topology có giá 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ụ để đảm bảo khả năng tương thích ngược.

Aug 12

  • Đã thêm ai_model: "meshy-7" vào API Ảnh sang 3D: mô hình tạo 3D mới nhất của chúng tôi, với hình học có độ trung thực cao hơn so với Meshy 6. Nó 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.
  • Đã thêm ai_model: "meshy-7" vào API Nhiều ảnh sang 3D: mô hình tạo Đa góc nhìn của Meshy, mô hình này xử lý 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à tạo texture dựa trên chúng.
  • Đã thêm ai_model: "meshy-7" vào API Tạo lại texture: 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 sạch hơn so với Meshy 6. Nó 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 để 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 chỉ hỗ trợ .glb, .stl, .obj). Sửa khả năng in trả về asset đã được 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ô hình 3D minifigure sưu tầm theo phong cách gạch lắp ghép. 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 riêng, 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 thiết kế keycap bàn phím cơ tùy chỉnh đầy đủ màu sắc. Quy trình hai giai đoạn — prototype (12 tín dụng) tạo ra bản render thiết kế keycap hoàn chỉnh, sau đó build (50 tín dụng) chuyể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 là gói GLB và OBJ, được xuất theo tỷ lệ milimét 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. Xem Giá để biết chi tiết đầy đủ.

Jul 21

  • Chúng tôi hiện hỗ trợ texture màu nền 8K thông qua tham số mới texture_resolution (2k / 4k / 8k) trên các endpoint Image to 3D, Multi-Image to 3D, Text to 3D Refine, và Retexture. Ở mức 8k, bản đồ PBR được tạo ở độ phân giải 4K và không tạo ra emission map. Việc tạo texture 8K tốn 15 tín dụng (2k/4k vẫn giữ 10). Xem Giá.
  • 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

  • API mới Creative Lab — Vinyl Figure API: biến một bức ảnh thành một tượng 3D sưu tầm bằng vinyl đầu to. 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 khái niệm theo 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 gọn gàng 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 dưới 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 để 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ị cho 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.

Tháng 6 năm 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 mã cURL, Python, hoặc JavaScript tương ứng. Có sẵn trên các gói Pro, Premium, Ultra, Studio và Enterprise.

Ngày 15 tháng 6

  • Mới UV Unwrap API: tạo bố cục UV chất lượng cao cho một mô hình 3D đã có — 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ụ tiếp theo. Nhận đầu vào là input_task_id (một tác vụ Ảnh sang 3D, Văn bản sang 3D, hoặc Remesh đã hoàn thành) 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 cho mỗi lần gọi. Hỗ trợ các mesh có tối đa 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 mỗi lượt gọi cho 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 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 được đặ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

  • API Creative Lab mới: một nhóm các endpoint theo phạm vi sản phẩm, biến một ảnh nguồn (hoặc prompt dạng 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 đầu tiên — Keychain, Fridge Magnet, Figure, và Lamp. Mỗi sản phẩm đều 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 phạm vi sản phẩm (/openapi/creative-lab/<product>/v1/...) với hệ thống phiên bản riêng cho từng sản phẩm để mỗi sản phẩm có thể phát triển theo 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 thumbnail 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ó không thay đổi. Việc này sẽ làm tăng thêm khoảng 3 giây vào độ trễ của tác vụ.

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ẽ vẫn 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 hì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ó không thay đổi. Việc này làm tăng thêm khoảng 3 giây vào thời gian xử lý 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 bao 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

  • Đã đánh dấu không dùng nữa tham số symmetry_mode trên các endpoint Text to 3D, Image to 3D, và Multi-Image to 3D. Tham số này không còn ảnh hưởng đến đầu ra.

May 7

  • API mới Analyze Printability: Phân tích một tác vụ Meshy đã thành công — hoặc bất kỳ URL mô hình 3D nào — để đánh giá mức độ sẵn sàng cho in 3D FDM. Theo mô hình tạo bất đồng bộ + stream: POST trả về task_id, sau đó GET / SSE stream trả về các chỉ số về tính kín nước (watertightness), thể tích, lỗ hổng và cạnh non-manifold khi trạng thái là SUCCEEDED. Miễn phí, không tiêu tốn tín dụng.
  • API mới Repair Printability: Sửa một mô hình 3D để đảm bảo khả năng in 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 năm 2026

Apr 27

  • Đã thêm trường consumed_credits vào tất cả phản hồi tác vụ trên mọi endpoint API. Trường này hiển thị số tín dụng đã tiêu thụ bởi mỗi tác vụ. 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ẽ được tự động 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 (thông qua URL hoặc Data URI) thay vì 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. Có thể 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: bổ sung tính năng nhóm tham số với các trường phụ thuộc, giá trị mặc định hiển thị trực tiếp, nhãn bắt buộc/không dùng nữa, điều hướng phụ có thể mở rộng, và tách Multi-Image, Rigging, và Animation thành các trang riêng biệt.

Tháng 3 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 kích hoạt khi yêu cầu rõ ràng.
  • API In nhiều màu mới: Chuyển đổi mô hình 3D sang định dạng 3MF 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 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ợ. 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 thị giác AI để ước tính chiều cao thực tế và tự động đổi kích thước mô hình. origin_at đặt vị trí gốc tọa độ (bottom hoặc center). Trong API Remesh, auto_size không thể sử dụng đồng thời 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 đầu vào. 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 Text to 3D Preview để tạo các 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

  • Đã thêm tài liệu chi tiết về Chế độ lỗi cho tất cả Endpoint API, bao gồm các mã lỗi HTTP phổ biến (400, 401, 402, 404, 422, 429) và 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 và xử lý lỗi API tốt hơn.

Jan 26

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

Jan 22

  • Đã đánh dấu không dùng nữa art_style cho API Văn bản sang 3D Preview (Meshy-6). Tham số này được thiết kế cho các mô hình 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 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 mô hình 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 lưới low-poly được tối ưu hóa cho các đa giác sạch hơn.

Tháng 12 năm 2025

Dec 31

  • Ra mắt API Playground, một không gian dành riêng để 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 của 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, cùng 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 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, Image to 3D, và Multi-Image to 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, thay vào đó hãy sử dụng pose_mode.

Tháng 11 2025

Nov 24

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

Nov 06

  • API Refine Văn bản sang 3D giờ đây hỗ trợ ai_model = latest, được phân giải thành Meshy 6 Preview.
  • API Ảnh sang 3D giờ đây mặc định sử dụng texturing 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 cho việc tạo texture theo mặc định trong khi việc tạo lưới vẫn là Meshy-5.
  • API Tạo lại texture bổ sung tùy chọn latest cho ai_model (Meshy-6-preview) và giờ đây 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 được tải lên.
  • Retexture API hiện đã giữ nguyên texture cho các mô hình được tải lên khi tùy chọn enable_original_uv được bật.

October 2025

Oct 28

  • Đã thêm header phản hồi x-api-version để cho biết 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 ưu đãi giảm giá tạm thời 50% cho các tác vụ tạo bằng Meshy-6-preview, còn 10 tín dụng, kéo dài đến hết ngày 30/09/2025. Sau thời gian ưu đãi, chi phí cho các tác vụ Meshy-6-preview sẽ trở lại 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

Tháng 8 năm 2025

Aug 18

13 Tháng 8

  • 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à độ nhất quán được cải thiện.

Tháng 7 2025

31 Tháng 7

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

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

May 2025

May 20

15 tháng 5

  • Giới thiệu API Tự động gắn khung xương & Hoạt hình (Auto-rigging & Animation), cho phép người dùng tự động gắn khung xương và tạo hoạt hình cho các mô hình 3D. Tìm hiểu thêm về Rigging và Animation.

Tháng 4 năm 2025

29 tháng 4

  • Giới thiệu Nhiều ảnh sang 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 Văn bản sang 3D và Ảnh sang 3D. Thẻ latest giờ đây cũng sẽ trỏ đến meshy-5.

Apr 17

  • Đã thêm tham số texture_image_url 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 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 hình.

Mar 14

Mar 06

  • Đã cập nhật giá cho các tác vụ tạo bằng 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 2025

Feb 18

  • Đã thêm khóa API chế độ thử nghiệm cho phép 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 phá vỡ tương thích:

    • 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í. Để đảm bảo quyền truy cập của bạn không bị gián đoạn, chúng tôi khuyến nghị bạn nên nâng cấp trước thời hạn này.
    • 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 phát Server-Sent Events (SSE) cho việc 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 dạng văn bản.

January 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) chạy trên các mô hình AI Meshy-3.

Jan 07

December 2024

Dec 19

  • Đã thêm các API Remesh, cho phép người dùng remesh và xuất các mô hình 3D hiện có được tạo bởi các API Meshy khác 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 trong khoảng 100-300.000 đối với người dùng Premium.

Dec 12

  • Đã ngừng dùng thuộc tính model_url trong tất cả các đối tượng phản hồi.
  • Đã tách API Meshy-3 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.

November 2024

Nov 14