nhật ký thay đổi

Xem tất cả các tính năng latest và bản cập nhật cho Meshy API và các plugin.

Tháng 6 năm 2026

Jun 17

  • Trang tài liệu API Playground mới: một console tương tác để thử các endpoint mà không cần viết mã, sau đó sao chép 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

  • API Trải UV mới: tạo bố cục UV chất lượng cao cho một mô hình 3D hiện 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ấp cho các công cụ ở giai đoạn sau. Nhận một 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 một 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ợ lưới lên đến 40.000 mặt (chạy Remesh trước nếu lớn hơn); lưới quad và n-gon đượ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ần gọi cho móc khóa, nam châm tủ lạnh, và tượng (trước đây là 20). đèn không thay đổi ở mức 30 tín dụng. Giá Prototype không thay đổi ở mức 6 tín dụng cho mỗi hình ảnh. Xem Giá để biết bảng phân tích đầy đủ.

Jun 5

1 tháng 6

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

Tháng 5 năm 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 hình thu nhỏ theo các góc nhìn chính (trước, phải, sau, trái) và trả về chúng trong trường phản hồi thumbnail_urls mới. Trường thumbnail_url hiện có không thay đổi. 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ừ API Remesh hiện đã có sẵn dưới dạng các endpoint API Chuyển đổi và API Đổi kích thước độc lập. Các tham số không dùng nữa trên Remesh sẽ tiếp tục hoạt động để tương thích ngược.

May 13

  • Đã thêm tham số multi_view_thumbnails vào API Ảnh sang 3D. Khi được đặt thành true, tác vụ sẽ kết xuất thêm bốn hình thu nhỏ theo các góc nhìn 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 hiện có thumbnail_url không thay đổi. Làm tăng độ trễ tác vụ thêm khoảng 3 giây.

May 12

  • Đã 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. Loại trừ lẫn nhau với resize_height và auto_size.

May 11

May 7

  • API Phân tích khả năng in mới: Phân tích một tác vụ Meshy đã SUCCEEDED — hoặc bất kỳ URL mô hình 3D nào — để đánh giá mức độ sẵn sàng cho in 3D FDM. Mẫu tạo bất đồng bộ + phát luồng: POST trả về task_id, sau đó luồng GET / SSE trả về độ kín nước, thể tích, lỗ và các chỉ số cạnh non-manifold sau khi SUCCEEDED. Miễn phí, không tiêu tốn tín dụng.
  • API Sửa khả năng in mới: Sửa một mô hình 3D cho khả năng in FDM — khắc phục cạnh non-manifold, mặt suy biến, lỗ 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 đầ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 API endpoint. Hiển thị số tín dụng được tiêu thụ bởi mỗi tác vụ. Trường này có mặt cho các tác vụ ở trạng thái PENDING, IN_PROGRESS và SUCCEEDED. Trả về 0 cho các tác vụ FAILED (tín dụng được tự động hoàn lại khi thất bại). Xem Giá để biết chi phí tín dụng cho mỗi 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ì 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 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 tất thay vì cung cấp image_url / image_urls. Khi cả hai đều được cung cấp, input_task_id 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, huy hiệu 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, Gắn xương (rigging), và Hoạt hình thành các trang riêng.

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ả endpoint (Ảnh sang 3D, Văn bản sang 3D, Remesh, Tạo lại texture). Lưu ý: 3MF chỉ là tùy chọn opt-in và phải được 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 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 sử dụng mô hình AI Meshy-4. Tất cả yêu cầu API sử dụng meshy-4 không còn được hỗ trợ. Vui lòng chuyển sang 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ử 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 loại trừ lẫn nhau với resize_height.

Mar 17

Tháng 2 năm 2026

Feb 28

Feb 25

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

Feb 20

Tháng 1 năm 2026

Jan 27

  • Đã thêm tài liệu Chế độ lỗi chi tiết 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à lý do 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 cho việc tạo lưới đầy đủ. Tham số ai_model hiện chấp nhận meshy-6 và latest sẽ phân giải thành Meshy 6.

Jan 22

  • Không dùng nữa (deprecated) art_style cho API Bản xem trước Văn bản sang 3D (Meshy-6). Tham số này được thiết kế cho các mô hình Legacy (Meshy-4 / Meshy-5) và sẽ bị xóa trong một bản phát hành trong tương lai.
  • Không dùng nữa (deprecated) 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ị xóa 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 hiện mặc định là false cho meshy-6, và true cho các mô hình khác nếu không được chỉ định.

Jan 19

Jan 12

  • Đã thêm một 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

31 tháng 12

  • Ra mắt API Playground, một không gian chuyên biệt để các nhà phát triển khám phá các tham số API và kiểm thử 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ừ lời nhắc văn bản và chỉnh sửa ảnh từ ả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 bản phát hành trong tương lai.

Dec 04

Tháng 11 năm 2025

Nov 24

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

Nov 06

  • API tinh chỉnh Văn bản sang 3D hiện hỗ trợ ai_model = latest, được phân giải thành Meshy 6 Preview.
  • API Ảnh sang 3D hiện 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 hiện hỗ trợ ai_model = latest, chạy Meshy-6-preview để tạo texture theo mặc định trong khi Tạo lưới vẫn là Meshy-5.
  • API Tạo lại texture thêm tùy chọn latest cho ai_model (Meshy-6-preview) và hiện mặc định sử dụng tùy chọn này khi bị bỏ qua.

Nov 04

  • Remesh API hiện giữ nguyên texture cho các mô hình đã tải lên.
  • Retexture API 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 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 API Remesh để 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 Đối tượng tác vụ rigging.

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 Meshy-6-preview xuống còn 10 tín dụng, kéo dài đến ngày 30 tháng 9 năm 2025. Sau thời gian giảm giá, chi phí của 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

  • Đã mở rộng hỗ trợ đầu vào model_url cho .glb, .gltf, .obj, .fbx, .stl dành cho Remesh và Tạo lại texture.

Tháng 8 năm 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 năm 2025

Jul 31

Tháng 6 năm 2025

Jun 25

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

Jun 19

Jun 17

Jun 10

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

Tháng 5 năm 2025

May 20

May 15

Tháng 4 năm 2025

Apr 29

  • Giới thiệu API Nhiều ảnh sang 3D, 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 hiện cũng phân giải thành meshy-5.

Apr 17

Tháng 3 năm 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 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 sinh.

Mar 14

  • API Văn bản sang texture hiện hỗ trợ các mô hình được mã hóa base64 trong tham số model_url thông qua Data URI, tương tự như image_url trong API Ảnh sang 3D.

Mar 06

  • Đã cập nhật giá cho các tác vụ tạo bằng API:
    • Văn bản sang 3D (Xem trước): Tăng từ 2 lên 5 tín dụng mỗi lần gọi
    • Văn bản sang 3D (Tinh chỉnh): 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 không có texture, 15 tín dụng 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
    • Văn bản sang Voxel: Giữ nguyên ở mức 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 msy_dummy_api_key_for_test_mode_12345678 cho phép nhà phát triển kiểm thử tích hợp API mà không tiêu thụ 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

Feb 6

Tháng 1 năm 2025

Jan 23

Jan 14

  • Đã đánh dấu không dùng nữa các API Legacy Văn bản sang 3D và Ảnh sang 3D được hỗ trợ bởi các mô hình AI Meshy-3.

Jan 07

Tháng 12 năm 2024

Dec 19

  • Đã thêm API Remesh, cho phép người dùng dựng lại lưới 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 (deprecated) 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 latest.

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 năm 2024

Ngày 14 tháng 11