lowpoly 將於 2026年10月30日 下線。 meshy-7 作為 3D 生成模型將於 2026年12月31日 下線;作為貼圖模型仍可使用。 請在這些日期前切換模型,以免請求出錯。 查看所有棄用資訊

棄用

查看哪些 Meshy AI 模型和 API 功能處於啟用、deprecated 或已停用狀態,並瞭解其停用日期和推薦替代方案。

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


概述

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

  • 啟用中: 完全受支援,推薦使用。
  • Legacy: 不再接收更新,未來可能會被 deprecated。它仍然可以正常運作,你的請求和帳單都不會有任何變化。
  • Deprecated: 仍然可以正常運作,但不再推薦使用。Meshy 會指定一個推薦的替代方案,一旦安排好,還會給出停用日期。
  • 已停用: 不再可用。使用已停用模型或功能的請求會回傳錯誤。

停用某個模型不會刪除你已經用它生成的內容。使用已停用模型建立的任務仍會在通常的保留期內保持可用。


遷移到替代方案

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

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


通知

Meshy 會在更新日誌和本頁面上公布每一次棄用和停用。在即將停用期間,每個 API 頁面頂部都會顯示一條橫幅提示,相應的端點頁面也會將該模型或參數標記為 deprecated。

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 生成模型。並非每個端點都提供所有模型;每個端點頁面會列出其支援的模型。

API 模型名稱目前狀態已棄用停用日期
meshy-7.1啟用中不適用不適用
meshy-7Deprecated2026 年 9 月 18 日2026 年 12 月 31 日(geometry);不適用(texture)
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-t1Deprecated2026 年 7 月 13 日2026 年 11 月 30 日
model_type: "lowpoly"Deprecated2026 年 7 月 13 日2026 年 11 月 30 日

latest 解析為 meshy-7.1。

meshy-7 的停用涵蓋其作為 Text to 3D preview 任務、Image to 3D 和 Multi-Image to 3D 的 ai_model 時的情況。meshy-7.1 接受相同的參數,費用也相同。自 2026 年 12 月 31 日起,這些請求將回傳 400。

meshy-7 作為 texture 模型不受影響。這涵蓋 Retexture、texture_model,以及 Text to 3D refine 的 ai_model(它只選取 texture 模型)。

截至 2026 年 11 月 30 日之前,以下請求仍會在具有三角形 topology 的 Smart Topology 模型上運行,並按 Smart Topology 的價格收費:

  • 使用 model_type: "smart-topology" 和 ai_model: "meshy-t1" 的 Image to 3D 請求,或者省略 ai_model(即使用 latest 或 meshy-6)並使用 model_type: "lowpoly" 的請求。Meshy 會忽略其中的 target_polycount、topology、image_enhancement、remove_lighting 和 experimental 參數。
  • 使用 model_type: "lowpoly" 且省略 ai_model(即使用 latest、meshy-6 或 meshy-4,其中 meshy-4 本已停用,這裡僅作為該回退方案而被接受)的 Text to 3D preview 請求。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 日model_type: "smart-topology" 配合 ai_model: "meshy-t2.5"
2026-09-29不帶 /openapi 前綴的 /v2/text-to-3d待公布/openapi/v2/text-to-3d
2026-09-18作為 Text to 3D preview、Image to 3D 和 Multi-Image to 3D 的 ai_model 的 meshy-72026 年 12 月 31 日meshy-7.1
2026-09-16共享測試模式 API 金鑰2026 年 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 日 deprecated仍可正常運作。該圖像會成為 rigged 模型的唯一 texture,模型將失去其 PBR 貼圖。省略該參數。Meshy 會使用 model_url 或輸入任務的 texture。
ultra_mode於 2026 年 9 月 18 日 deprecatedultra_mode: true 等同於 geometry_resolution: "2k"。geometry_resolution
hd_texture於 2026 年 7 月 21 日 deprecatedhd_texture: true 等同於 texture_resolution: "4k"。如果兩者同時傳送,Meshy 會使用 texture_resolution。texture_resolution
Remesh 的 Convert 和尺寸調整參數於 2026 年 5 月 22 日 deprecated仍可正常運作。Convert 和尺寸調整
symmetry_mode於 2026 年 5 月 11 日 deprecated接受但會被忽略。省略該參數。
Text to 3D Preview 上的 art_style於 2026 年 1 月 22 日 deprecated接受但會被忽略。此前它僅適用於 Meshy 4 和 Meshy 5。省略該參數。
is_a_t_pose於 2025 年 12 月 4 日 deprecated仍可正常運作。pose_mode