棄用說明
查看哪些 Meshy AI 模型和 API 功能處於活躍、已棄用或已停用狀態，並瞭解停用日期和建議的替代方案。
隨著 Meshy 發布新模型，舊模型會被停用。依賴舊模型或 API 功能的整合可能需要偶爾更新才能繼續正常運作。本頁列出了所有 API 棄用情況，以及各自建議的替代方案。
概述
Meshy 使用以下術語來描述模型或 API 功能的生命週期：
- 活躍（Active）： 完全受支援，建議使用。
- Legacy： 不再接收更新，未來可能會被標記為已棄用。它仍然可以使用，你的請求和帳單不會受到任何影響。
- Deprecated： 仍然可以使用，但不再建議。Meshy 會指定建議的替代方案，並在確定之後給出停用日期。
- 已停用（Retired）： 不再可用。使用已停用模型或功能的請求將回傳錯誤。
停用一個模型不會刪除你之前用它生成的內容。使用已停用模型建立的任務仍會在通常的保留期內保持可用。
遷移至替代方案
一旦某個模型被標記為已棄用，請在停用日期之前將所有請求遷移到其替代方案。停用日期之後使用該模型的請求將會失敗。
替代方案生成的結果可能與被替代的模型不同。請在停用日期之前充分測試你的整合是否能與替代方案正常配合，例如可以在 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 模型名稱 | 目前狀態 | Deprecated 日期 | 停用日期 |
|---|---|---|---|
meshy-7.1 | 活躍 | 無 | 無 |
meshy-7 | Deprecated | 2026 年 9 月 18 日 | 待公布 |
meshy-6 | 活躍 | 無 | 無 |
meshy-6-lite | 活躍 | 無 | 無 |
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 年 10 月 30 日 |
model_type: "lowpoly" | Deprecated | 2026 年 7 月 13 日 | 2026 年 10 月 30 日 |
latest 解析為 meshy-7.1。
棄用歷史
以下列出了所有棄用情況，按公告時間從新到舊排列。
| 公告日期 | 被棄用的模型或功能 | 停用日期 | 建議替代方案 |
|---|---|---|---|
| 2026-10-02 | Text to 3D 和 Image to 3D 上的 model_type: "lowpoly" 和 meshy-t1 | 2026 年 10 月 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 金鑰 | 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 和 Resize |
symmetry_mode | 2026 年 5 月 11 日起已棄用 | 可接受，但會被忽略。 | 省略該引數。 |
Text to 3D Preview 中的 art_style | 2026 年 1 月 22 日起已棄用 | 可接受，但會被忽略。它此前僅適用於 Meshy 4 和 Meshy 5。 | 省略該引數。 |
is_a_t_pose | 2025 年 12 月 4 日起已棄用 | 仍然可以使用。 | pose_mode |