棄用
查看哪些 Meshy AI 模型和 API 功能處於啟用、deprecated 或已停用狀態,並瞭解其停用日期和推薦替代方案。
隨著 Meshy 發布新模型,舊模型會被停用。依賴舊模型或 API 功能的整合可能需要偶爾更新才能繼續正常運作。本頁列出了每一項 API 棄用,以及對應的推薦替代方案。
概述
Meshy 使用以下術語來描述模型或 API 功能的生命週期:
- 啟用中: 完全受支援,推薦使用。
- Legacy: 不再接收更新,未來可能會被 deprecated。它仍然可以正常運作,你的請求和帳單都不會有任何變化。
- Deprecated: 仍然可以正常運作,但不再推薦使用。Meshy 會指定一個推薦的替代方案,一旦安排好,還會給出停用日期。
- 已停用: 不再可用。使用已停用模型或功能的請求會回傳錯誤。
停用某個模型不會刪除你已經用它生成的內容。使用已停用模型建立的任務仍會在通常的保留期內保持可用。
遷移到替代方案
一旦某個模型被 deprecated,請在停用日期之前將所有請求遷移到其替代方案。停用日期之後使用該模型的請求將會失敗。
替代方案產生的結果可能與它所替代的模型不同。請在停用日期之前充分測試你的整合與替代方案的相容性,例如在 Playground 中進行測試。
通知
Meshy 會在更新日誌和本頁面上公布每一次棄用和停用。在即將停用期間,每個 API 頁面頂部都會顯示一條橫幅提示,相應的端點頁面也會將該模型或參數標記為 deprecated。
Meshy 會在停用前至少一個月公布停用日期。
最佳實踐
- 定期查看更新日誌和本頁面,瞭解棄用相關的更新。
- 如果你的整合需要保持一致的輸出,請將
ai_model設定為具體的模型,例如meshy-7.1。latest始終指向最新的標準模型,因此當發布新模型時,其輸出會發生變化。 - 在目前模型的停用日期之前,充分測試你的整合與替代方案的相容性。
- 盡快更新你的程式碼,以使用推薦的替代方案。
- 如果在遷移過程中需要協助,請聯絡 support@meshy.ai。
模型狀態
Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture 目前及已停用的 3D 生成模型。並非每個端點都提供所有模型;每個端點頁面會列出其支援的模型。
| API 模型名稱 | 目前狀態 | 已棄用 | 停用日期 |
|---|---|---|---|
meshy-7.1 | 啟用中 | 不適用 | 不適用 |
meshy-7 | Deprecated | 2026 年 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-t1 | Deprecated | 2026 年 7 月 13 日 | 2026 年 11 月 30 日 |
model_type: "lowpoly" | Deprecated | 2026 年 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-02 | Text to 3D 和 Image to 3D 上的 model_type: "lowpoly" 和 meshy-t1 | 2026 年 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-7 | 2026 年 12 月 31 日 | meshy-7.1 |
| 2026-09-16 | 共享測試模式 API 金鑰 | 2026 年 9 月 16 日 | 來自 API Keys 頁面的你自己的金鑰,或 Playground |
| 2026-09-11 | meshy-5 | 2026 年 10 月 10 日 | meshy-6-lite |
| 2026-03-20 | meshy-4 | 2026 年 3 月 20 日 | meshy-6 |
| 2025-10-01 | Text to Voxel API | 2025 年 10 月 1 日 | 無 |
| 2025-07-01 | Text to Texture API | 2025 年 7 月 1 日 | Retexture |
| 2025-01-14 | meshy-3 | 2025 年 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 日 deprecated | ultra_mode: true 等同於 geometry_resolution: "2k"。 | geometry_resolution |
hd_texture | 於 2026 年 7 月 21 日 deprecated | hd_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 |