棄用
查看哪些 Meshy AI 模型和 API 功能處於活躍、已棄用或已停用狀態,並了解停用日期和建議的替代方案。
隨著 Meshy 發布新模型,舊模型會陸續停用。依賴舊模型或 API 功能的整合可能需要偶爾更新才能繼續正常運作。本頁列出了每一項 API 棄用,以及對應的建議替代方案。
概述
Meshy 使用以下術語來描述模型或 API 功能的生命週期:
- 活躍: 完全支援,建議使用。
- Legacy: 不再獲得更新,未來可能會被棄用。它仍然可以使用,你的請求或帳單不會有任何變化。
- 已棄用: 仍然可以使用,但不再建議使用。Meshy 會指定建議的替代方案,並在確定排程後給出停用日期。
- 已停用: 不再可用。使用已停用模型或功能的請求會回傳錯誤。
停用一個模型並不會刪除你已經用它產生的內容。使用已停用模型建立的任務會在通常的保留期限內持續可用。
遷移至替代方案
一旦某個模型被棄用,請在停用日期之前將所有請求遷移至其替代方案。停用日期之後使用該模型的請求將失敗。
替代方案產生的結果可能與被替代的模型不同。請在停用日期之前充分測試你的整合與替代方案的相容性,例如在 Playground 中進行測試。
通知
Meshy 會在更新日誌和本頁面上公告每一項棄用和停用。在停用即將到來時,每個 API 頁面頂部都會顯示相應的橫幅提示,相關 endpoint 頁面也會將該模型或引數標記為已棄用。
Meshy 會在停用日期前至少一個月公布具體日期。
最佳實務
- 定期查看更新日誌和本頁面,了解棄用動態。
- 如果你的整合需要穩定一致的輸出,請將
ai_model設定為某個具體模型,例如meshy-7.1。latest始終指向最新的標準模型,因此當新模型發布時,其輸出會發生變化。 - 請在目前模型的停用日期之前,充分測試你的整合與替代方案的相容性。
- 盡快更新你的程式碼以使用建議的替代方案。
- 如果在遷移過程中需要協助,請聯絡 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-02 | Text to 3D 和 Image to 3D 上的 model_type: "lowpoly" 和 meshy-t1 | 2026 年 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-18 | meshy-7 | 待公布 | meshy-7.1 |
| 2026-09-16 | 共享測試模式 API key | 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 日棄用 | 仍然可用。該圖像會成為綁定骨骼模型的唯一 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 |