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à cập nhật mới nhất của Meshy API và các plugin.

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

Oct 15

  • Đã thêm ai_model: "meshy-t2.5" vào API Ảnh sang 3D và Văn bản sang 3D: mô hình Smart Topology mới nhất, mang lại chi tiết sắc nét hơn cho các asset trò chơi. Hãy sử dụng kèm với model_type: "smart-topology"; đầu ra chỉ gồm tam giác, và target_polycount nhận giá trị từ 100 đến 30.000 (mặc định là 15.000). Giá áp dụng tương tự meshy-t2; xem Giá. Đây hiện là lựa chọn mặc định khi model_type: "smart-topology" được thiết lập mà không kèm ai_model; hãy đặt ai_model: "meshy-t2" nếu muốn tiếp tục sử dụng Meshy T2. Nhiều ảnh sang 3D không hỗ trợ meshy-t2.5.

Oct 14

  • model_url giờ đây chấp nhận file lên đến 400 MB, tăng từ 100 MB, khi đó là một URL http hoặc https, trên Tạo lại texture, Remesh, Rigging, Chuyển đổi, Đổi kích thước, Trải UV, Multi-Color Print, Phân tích khả năng in và Sửa khả năng in. Một data: URI vẫn giữ ở mức 100 MB. Một file GLB, glTF, FBX hoặc OBJ vượt quá 100 MB có thể có tối đa 10.000.000 mặt (8.000.000 đối với Multi-Color Print), được tính theo số tam giác; một file có nhiều hơn sẽ trả về 400. Vượt quá 100 MB, file FBX phải là FBX nhị phân phiên bản 7.1 trở lên, và file GLB hoặc glTF không được sử dụng nén Draco. File được tải xuống trước khi yêu cầu tạo trả về kết quả, vì vậy hãy chờ tối đa 120 giây đối với một file lớn (xem Task Lifecycle). Các file có kích thước từ 100 MB trở xuống hoạt động như trước, và giá không thay đổi.
  • Phân tích khả năng in giờ đây trả về 404 với cùng nội dung body như một id không tồn tại, khi input_task_id thuộc về một tài khoản khác, thay vì 403. Một task của bạn, hoặc của một thành viên trong nhóm thuộc không gian làm việc mà bạn tham gia, vẫn hoạt động như trước.

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 khi xem 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ụ Văn bản sang 3D, Ảnh sang 3D, Nhiều ảnh sang 3D, Tạo lại texture, Remesh, Chuyển đổi, Đổi kích thước và Auto Split giờ đây khai báo metersPerUnit = 1. Trước đây, nó khai báo đơn vị feet (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 lên 3.28 để bù trừ cho điều này, 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à Hoạt hình không bị ảnh hưởng.

Oct 10

  • meshy-5 đã bị ngừng hỗ trợ. Các request gửi ai_model: "meshy-5" tới Text to 3D, Image to 3D, Multi-Image to 3D hoặc Retexture giờ sẽ trả về 400 với thông báo ai_model meshy-5 has been retired; use meshy-6-lite. Hãy chuyển sang meshy-6-lite, loại này sử dụng cùng các tham số với cùng mức chi phí credit. Các model bạn đã tạo trước đó bằng meshy-5 vẫn khả dụng, và việc refine một bản preview của meshy-5 mà không thiết lập ai_model vẫn hoạt động bình thường.
  • .webp hiện đã được ghi nhận là định dạng ảnh đầu vào được hỗ trợ, bên cạnh .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á vẫn giữ nguyên.
  • Get Balance giờ đây cũng trả về monthly_credits, permanent_credits và monthly_resets_at, nhờ đó bạn có thể biết được phần nào trong số dư của mình sẽ hết hạn vào lần làm mới tiếp theo. Bản thân balance không có gì 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, 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, đồ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.

September 2026

Sep 29

  • Đường dẫn Legacy /v2/text-to-3d (không có tiền tố /openapi) đã không dùng nữa. Nó vẫn hoạt động không thay đổi trong thời điểm hiện tại, nhưng sẽ bị xóa trong một bản phát hành tương lai — hãy chuyển sang /openapi/v2/text-to-3d, đường dẫn này nhận cùng một request và trả về cùng một response. Các response trên đường dẫn Legacy giờ đây mang theo header Deprecation và header Link trỏ đến đường dẫn mới.

Sep 28

  • Các response của API giờ đây bao gồm header giới hạn tốc độ, bao gồm Retry-After để cho bạn biết cần đợi bao lâu trước khi thử lại hoặc polling lại.
  • In nhiều màu giờ đây chấp nhận tham số printer_brand mới, tham số này ghi một preset phần mềm cắt lớp phù hợp vào tệp 3MF, để tệp mở ra đã 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 (mặc định). Trang này giờ đây 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: thông số và chi phí tín dụng giống như meshy-7, nhưng 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.
  • Đã 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 "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í 5 tín dụng bổ sung 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: thao tác 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 đơn sắc cho mỗi phần — điều này vốn đã đúng với mọi thao tác tách và không thay đổi.
  • meshy-5 sẽ bị ngừng sử dụng vào ngày 10 tháng 10 năm 2026. Giá trị này không còn được ghi trong tài liệu như một giá trị ai_model dành cho Văn bản sang 3D, Ảnh sang 3D, Nhiều ảnh sang 3D hay 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 đã bị ngừng sử dụng; các yêu cầu vẫn gửi khóa đó 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 API 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 là gì, nên nó chưa 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 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 trong tài khoản của bạn giống 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 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 hạng OpenAI GPT Image 2.5, có giá giống như 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 chấp nhận các 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, ngoài 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 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 các URL đầu ra của nó vào reference_image_urls.

Sep 11

  • Thay đổi hành vi: thao tác 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 số tín dụng, vì chỉ có tác vụ ở trạng thái PENDING mới được hoàn tiền, nghĩa là lệnh gọi đó khiến bạn mất cả mô hình lẫn tín dụng mà không có gì trong phản hồi cho biết điều đó. Nếu 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ụ mà worker đã bắt đầu xử lý thì không thể hủy được: hãy đợi đế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 tiền chính xác như trước, và các tác vụ ở trạng thái cuối cùng vẫn được xóa như bình thường. Áp dụng cho mọi nhóm tác vụ thuộc /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 việc tạo lại texture).
  • meshy-5 giờ đây đã không dùng nữa trên mọi API có hỗ trợ 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 tích hợp của bạn 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 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 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ưới dạng đã lắp ráp hoặc được bố trí 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 prototype của Creative Lab Keychain API: khắc một tên gồm 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ụ prototype 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.

5 Tháng 9

  • Đã thêm API Creative Lab Fidget Pixel: biến một bức ảnh thành một 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 bức ảnh thà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 lồng vào nhau dạng square hoặc hex, được xuất dưới dạng một file 3MF gắn thẻ màu duy nhất để in đa sợi (multi-filament). 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 preset action 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, để bạn có thể tự xây dựng bộ chọn action 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 đó phần đường viền 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 rồi kéo giãn ra trở 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 sẽ đư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 để tinh 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 ảnh concept thành một chao đèn rỗng dạng GLB, và đối tượng task của 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 với một 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 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 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. Tốn 3 tín dụng cho mỗi hành động, và post_process được áp dụng cho tệp đã 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) để có hình học với độ chính xác cao hơn và chi tiết bề mặt sắc nét hơn, với chi phí thêm 5 tín dụng — đây chính là bước xử lý 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 tài liệu hóa cho model_type Smart Topology của API Ảnh sang 3D. Smart Topology hiện chỉ còn tài liệu hóa 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 được 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 tác vụ API theo chương 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à hệ thống tài chính.

Aug 26

  • Animation API giờ đây đã hỗ trợ 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 gắn rig của bạn, như một lựa chọn thay thế cho action_id dựng 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 chưa được hỗ trợ cho mô hình này.

Aug 21

  • Đã thêm Text to Motion API: tạo một đoạn chuyển động nhân vật từ mô tả bằng ngôn ngữ tự nhiên, không cần mô hình nhân vật. Chọn prime mode (10 tín dụng, đầu ra FBX) để có chất lượng cao nhất hoặc swift mode (3 tín dụng, đầu ra BVH) để tạo nhanh, tiết kiệm, với thời lượng đoạn 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 chuẩn 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 tạo 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 được ả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 bật chế độ tạo Ultra để có chi tiết bề mặt tinh tế hơn với 5 tín dụng phụ trội. Để tạo texture với Meshy 7, hãy truyền ai_model: "meshy-7" trên tác vụ refine hoặc bỏ hẳ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 sạch hơn, các bộ phận được tách riêng một cách tự nhiên, xuất dạng tam giác, và số lượng mặt bạn có thể đặt 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 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ó độ chân 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 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 để tạo texture.
  • Đã 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 cho .glb, .gltf, .obj, .fbx, .stl đối với 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 đã đượ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 hình ảnh concept đã được tạo kiểu, build (30 tín dụng) biến nó thành mô hình 3D có texture với các đầ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 một 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) biến thiết kế bạn chọn (thông qua candidate_id) thành một mô hình keycap 3D có texture với các đầu ra dạng 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

  • 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, Văn bản sang 3D Refine, 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 đồ emission 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. 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 sạch hơn, các bộ phận được tá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ờ đã 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 đối với các mô hình nano-banana và 1:1, 3:2, 2:3 đối với gpt-image-2. Tùy chọn; 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 mã 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: API Trải UV: 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 lên 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ông đoạn sau. Nhận vào 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 mỗi lần gọi. Hỗ trợ các mesh lên đến 40.000 mặt (chạy Remesh trước nếu lớn hơn); các mesh dạng quad và n-gon 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 đổi ở mức 30 tín dụng. Giá Prototype không đổi ở mức 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 nền trong suốt (RGBA) của bản xem trước và trả về trong trường phản hồi mới alpha_thumbnail_url. Trường thumbnail_url hiện có không thay đổi. 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 gốc (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 ra mắt — 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 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ẽ kết xuất 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 thêm khoảng 3 giây độ 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ẽ 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ẽ kết xuất 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. Tăng thêm khoảng 3 giây độ trễ 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 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

  • Đã 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 kết quả đầu ra nữa.

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 — để đá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ề một task_id, sau đó GET / SSE stream trả về các chỉ số về tính kín nước, 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.
  • Repair Printability API mới: 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 của Meshy đã có sẵn 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 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ố 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 hoàn lại tự động 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 Multi-Color Print. 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 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, thanh đ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 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ỉ khả dụng khi được bật và phải được yêu cầu rõ ràng.
  • API mới Multi-Color Print: 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 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 sẽ 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 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 ảnh đầ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 ra 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à các nguyên nhân khiế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ính năng 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 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.
  • 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 hiện 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 Image to 3D để tạo các lưới low-poly được tối ưu hóa nhằm cho ra 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 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 Text to Image API và Image to Image API, 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 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

November 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à trả về model_urls.pre_remeshed_glb khi có yêu cầu sao lưu trước khi 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 việc 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, mặc định chạy Meshy-6-preview để tạo texture 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 đối với các mô hình đã tải lên.
  • Retexture API hiện giữ nguyên texture đối với các mô hình đã 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 để biểu thị 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 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, giảm xuống còn 10 tín dụng, kéo dài đến hết ngày 30 tháng 9, 2025. Sau thời gian giảm giá, 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

August 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

June 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 định dạng GLB mã hóa base64 trong tham số model_url thông qua Data URI.

May 2025

May 20

15 tháng 5

Tháng 4 2025

29 tháng 4

  • 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 giờ đây cũng sẽ trỏ đến meshy-5.

Apr 17

Tháng 3 2025

Mar 28

  • Đã thêm tham số latest vào 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 nâng cao sắp ra mắt của chúng tôi để cải thiện chất lượng tạo sinh.

Mar 14

  • Text to Texture API giờ đây hỗ trợ các model được mã hóa base64 trong tham số model_url thông qua Data URI, tương tự như image_url trong Image to 3D API.

Mar 06

  • Đã cập nhật Giá cho các tác vụ tạo sinh 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 tại 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

February 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

  • Các thay đổi lớn:

    • 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âng cấp trước thời hạn này.
    • Sử dụng mã giảm giá APIACCESS để được 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 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 prompt văn bản.

January 2025

Jan 23

Jan 14

  • Đã không dùng nữa các API Văn bản sang 3D và Ảnh sang 3D cũ sử dụng mô hình AI Meshy-3.

Jan 07

December 2024

Dec 19

  • Đã thêm 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 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 đối với người dùng Premium.

Dec 12

  • Đã ngừng sử dụng (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