lowpoly 將於 2026年10月30日 下線。 請在這些日期前切換模型,以免請求出錯。 查看所有棄用資訊

棄用

查看哪些 Meshy AI 模型和 API 功能處於活躍、已棄用或已停用狀態,並了解停用日期和建議的替代方案。

隨著 Meshy 發布新模型,舊模型會陸續停用。依賴舊模型或 API 功能的整合可能需要偶爾更新才能繼續正常運作。本頁列出了每一項 API 棄用,以及對應的建議替代方案。


概述

Meshy 使用以下術語來描述模型或 API 功能的生命週期:

  • 活躍: 完全支援,建議使用。
  • Legacy: 不再獲得更新,未來可能會被棄用。它仍然可以使用,你的請求或帳單不會有任何變化。
  • 已棄用: 仍然可以使用,但不再建議使用。Meshy 會指定建議的替代方案,並在確定排程後給出停用日期。
  • 已停用: 不再可用。使用已停用模型或功能的請求會回傳錯誤。

停用一個模型並不會刪除你已經用它產生的內容。使用已停用模型建立的任務會在通常的保留期限內持續可用。


遷移至替代方案

一旦某個模型被棄用,請在停用日期之前將所有請求遷移至其替代方案。停用日期之後使用該模型的請求將失敗。

替代方案產生的結果可能與被替代的模型不同。請在停用日期之前充分測試你的整合與替代方案的相容性,例如在 Playground 中進行測試。


通知

Meshy 會在更新日誌和本頁面上公告每一項棄用和停用。在停用即將到來時,每個 API 頁面頂部都會顯示相應的橫幅提示,相關 endpoint 頁面也會將該模型或引數標記為已棄用。

Meshy 會在停用日期前至少一個月公布具體日期。


最佳實務

  1. 定期查看更新日誌和本頁面,了解棄用動態。
  2. 如果你的整合需要穩定一致的輸出,請將 ai_model 設定為某個具體模型,例如 meshy-7.1。latest 始終指向最新的標準模型,因此當新模型發布時,其輸出會發生變化。
  3. 請在目前模型的停用日期之前,充分測試你的整合與替代方案的相容性。
  4. 盡快更新你的程式碼以使用建議的替代方案。
  5. 如果在遷移過程中需要協助,請聯絡 support@meshy.ai。

模型狀態

Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture 目前及已停用的 3D 生成模型。並非每個 endpoint 都支援所有模型;每個 endpoint 頁面都列出了其接受的模型。

API 模型名稱目前狀態棄用日期停用日期
meshy-7.1活躍不適用不適用
meshy-7已棄用2026 年 9 月 18 日待公布
meshy-6活躍不適用不適用
meshy-6-lite活躍不適用不適用
meshy-n1活躍不適用不適用
meshy-5已停用2026 年 9 月 11 日2026 年 10 月 10 日
meshy-4已停用不適用2026 年 3 月 20 日
meshy-3已停用2025 年 1 月 14 日2025 年 7 月
meshy-t2.5活躍不適用不適用
meshy-t2活躍不適用不適用
meshy-t1已棄用2026 年 7 月 13 日2026 年 11 月 30 日
model_type: "lowpoly"已棄用2026 年 7 月 13 日2026 年 11 月 30 日

latest 解析為 meshy-7.1。

在 2026 年 11 月 30 日之前,以下請求仍會在使用三角面 topology 的 Smart Topology 模型上執行,並按照 Smart Topology 的價格收費:

  • Image to 3D,使用 model_type: "smart-topology" 和 ai_model: "meshy-t1",或使用 model_type: "lowpoly" 且不傳入 ai_model、傳入 latest 或 meshy-6。此時 Meshy 會忽略 target_polycount、topology、image_enhancement、remove_lighting 和 experimental。
  • Text to 3D 預覽請求,使用 model_type: "lowpoly" 且不傳入 ai_model、傳入 latest、meshy-6 或 meshy-4(meshy-4 原本已停用,僅在此回退情境下被接受)。此時 Meshy 會忽略 target_polycount、topology 和 experimental。

其他所有使用 meshy-t1 或 lowpoly 的請求現已回傳 400。自 2026 年 11 月 30 日起,上述請求也將回傳 400。


棄用歷史

以下列出了所有棄用,按公告時間從新到舊排列。

公告日期已棄用的模型或功能停用日期建議替代方案
2026-10-02Text to 3D 和 Image to 3D 上的 model_type: "lowpoly" 和 meshy-t12026 年 11 月 30 日使用 ai_model: "meshy-t2.5" 的 model_type: "smart-topology"
2026-09-29不帶 /openapi 前綴的 /v2/text-to-3d待公布/openapi/v2/text-to-3d
2026-09-18meshy-7待公布meshy-7.1
2026-09-16共享測試模式 API key2026 年 9 月 16 日來自 API Keys 頁面的你自己的金鑰,或使用 Playground
2026-09-11meshy-52026 年 10 月 10 日meshy-6-lite
2026-03-20meshy-42026 年 3 月 20 日meshy-6
2025-10-01Text to Voxel API2025 年 10 月 1 日無
2025-07-01Text to Texture API2025 年 7 月 1 日Retexture
2025-01-14meshy-32025 年 7 月meshy-6

API 參數棄用

Meshy 偶爾會棄用一些被新模型取代或不再使用的請求引數和回應欄位。除非另有說明,它們仍然可以使用,但未來的版本可能會移除它們。

參數狀態行為建議替代方案
Rigging 上的 texture_image_url已於 2026 年 10 月 23 日棄用仍然可用。該圖像會成為綁定骨骼模型的唯一 texture,模型會失去其 PBR 貼圖。省略該引數。Meshy 會使用 model_url 或輸入任務自身的 texture。
ultra_mode已於 2026 年 9 月 18 日棄用ultra_mode: true 等同於 geometry_resolution: "2k"。geometry_resolution
hd_texture已於 2026 年 7 月 21 日棄用hd_texture: true 等同於 texture_resolution: "4k"。如果兩者同時傳入,Meshy 會使用 texture_resolution。texture_resolution
Remesh 的 Convert 和 resize 引數已於 2026 年 5 月 22 日棄用仍可使用。Convert 和尺寸調整
symmetry_mode已於 2026 年 5 月 11 日棄用可以傳入,但會被忽略。省略該引數。
Text to 3D 預覽中的 art_style已於 2026 年 1 月 22 日棄用可以傳入,但會被忽略。該引數此前僅適用於 Meshy 4 和 Meshy 5。省略該引數。
is_a_t_pose已於 2025 年 12 月 4 日棄用仍然可用。pose_mode