更新日誌

查看所有 Meshy API 和插件的最新功能和更新。

2026 年 8 月

8 月 13 日

  • 增加了 ai_model: "meshy-7" 到 文字生成 3D API：我們最新的 3D 生成模型，具備比 Meshy 6 更高的幾何細節。它還引入了 ultra_mode 引數於預覽任務中，允許使用 Ultra 生成更多精細的表面細節，額外消耗 5 積分。要使用 Meshy 7 進行貼圖，在細化任務中傳遞 ai_model: "meshy-7" 或完全省略 ai_model。
  • 加入 Smart Topology model_type 到 文字生成 3D API。設定 model_type: "smart-topology" 使用 meshy-t2 生成—更簡潔的 topology，自然分離的部件，三角形輸出，以及可以通過 target_polycount 設置的面數（100 到 15,000，默認為 4,000）。Smart Topology 預覽費用為5積分而不是20；參見 價格。現有的 model_type: "lowpoly" 已廢除但仍可供向後兼容使用。

8 月 12 日

  • 增加了 ai_model: "meshy-7" 到 影象生成 3D API：我們最新的 3D 生成模型，具備比 Meshy 6 更高的幾何細節。它還引入了 ultra_mode 引數，允許使用 Ultra 生成更多精細的表面細節。
  • 增加了 ai_model: "meshy-7" 到 多圖生成 3D API：Meshy 的多視圖生成模型，根據所有輸入視圖進行調整並驅動貼圖。
  • 增加了 ai_model: "meshy-7" 到 重新貼圖 API：我們最新的貼圖模型，具有比 Meshy 6 更鋒利的表面細節和更清潔的 PBR 材質。它還引入了 multiview_image_urls 引數—提供 1–4 個相同物件的有序視圖來驅動多視圖貼圖。

8 月 4 日

  • 擴展了 可列印性分析 和 可列印性修復 端點的 model_url 輸入支持 .glb, .gltf, .obj, .fbx, .stl (先前僅支持 .glb, .stl, .obj)。修復返回其輸入格式中的修復資產。

2026 年 7 月

7 月 27 日

  • 全新的 Creative Lab — 方塊小人 API：將照片變成磚塊風格的可收藏 3D 迷你人偶。與 Q 版手辦 API 使用相同的兩階段工作流程—prototype (6 積分) 生成樣式化概念影象，build (30 積分) 將其轉換為具有 GLB 和 OBJ + MTL 輸出的貼圖 3D 模型。查看 價格 詳細分解。

7 月 22 日

  • 新的 Creative Lab — 鑰匙扣 API：將照片轉換為全彩自訂機械鍵盤鍵帽。兩階段工作流程—prototype (12 積分) 生成完成的鍵帽設計渲染，然後通過 candidate_id 選擇的設計轉為 textured 3D 鍵帽模型，其輸出包含 GLB 和 OBJ 套件，並以現實世界毫米規模輸出。當前支持標準的 Cherry MX 1u 底座（cherry-mx-1x1-r1）；計劃增加更多標準尺寸。查看 價格 了解完整細分。

7 月 21 日

  • 我們現在支持透過新增的 texture_resolution 引數（2k / 4k / 8k）在 影像生成 3D、多圖生成 3D、文字生成 3D 細化 和 重新貼圖 端點生成 8K 基色貼圖。在 8k 時，PBR 地圖會生成 4K 並且不會生成發光地圖。8K 紋理生成費用為 15 積分（2k/4k 保持 10）。查看 價格。
  • hd_texture 布林值已廢止，取而代之的是 texture_resolution—仍然授權並等同於向後兼容的 texture_resolution: "4k" 。

7 月 20 日

  • 新的 Creative Lab — 大頭公仔 API：將照片轉換為可收藏的大頭乙烯基 3D 公仔。與 Q 版手辦 API 使用相同的兩階段工作流程—prototype (6 積分) 生成樣式化概念影象，build (30 積分) 將其轉換為具有 GLB 和 OBJ + MTL 輸出的貼圖 3D 模型。查看 價格 詳細分解。

7 月 13 日

  • 增加了新的 Smart Topology model_type 到 影象生成 3D API，提供兩個模型透過 ai_model: meshy-t1 - 當前的低多邊形模型 - 和 meshy-t2 - 具有更乾淨 topology，自然分離部件、三角形輸出以及可以通過 target_polycount 設定的面數的新模型。meshy-t2 是 smart-topology 的預設值。現有的 model_type: lowpoly 現在已廢止，但繼續服務以確保向後兼容。

7 月 7 日

  • 為 影像生成影象 API 新增 aspect_ratio 引數，以便在編輯時控制輸出圖片比例。納入的值有 1:1, 16:9, 9:16, 4:3, 3:4 用於納米香蕉模型 和 1:1, 3:2, 2:3 用於 gpt-image-2。選擇性；預設為 1:1，且無法與 generate_multi_view 一起使用。

2026 年 6 月

6 月 17 日

  • 全新的 API Playground 文件頁面：一個可在不編寫代碼的情況下試用端點的互動控制台，然後復製等效的 cURL、Python 或 JavaScript。可供 Pro, Premium, Ultra, Studio 和 Enterprise 計畫使用。

6 月 15 日

  • 新的 UV 展開 API: 為現有的 3D 模型生成高品質 UV 佈局 - 在進行貼圖之前或在任何時候需要為下游工具準備乾淨、沒有重疊的 UV 佈局時為必要步驟。接收 input_task_id (完成的影象生成 3D，文字生成 3D 或重構網格任務）或 model_url (.glb 只有) 並將其作為新生成的 UV 座標“UV 白模”返回。每次通話消耗 5 積分。支持高達 40,000 面的網格（如果超過，則先運行 重構網格）；四邊形和 n-gon 網格在 UV 生成期間被三角化。

6 月 12 日

  • 更新 Creative Lab API 構建價格為每次通話 30 積分 用於 鑰匙扣, 冰箱貼, 和 Q 版手辦 (先前為 20)。燈具保持不變為 30 積分。每張影像的原型價格保持不變為 6 積分。查看 價格 詳細分解。

6 月 5 日

6 月 1 日

  • 新的 Creative Lab APIs：一系列將來源照片（或文字 prompt）轉換為 3D 可列印消費者產品的產品定域端點。在啟動時有四種產品—鑰匙扣, 冰箱貼, Q 版手辦, 和 燈具。每個都遵循 prototype → build 的兩階段工作流程，藉由 input_task_id 鏈接，並在產品搜尋版本控制下，通過產品定域 URL (/openapi/creative-lab/<product>/v1/...) 彌補版本，從而可以獨立版本線上演化產品。原型：6 積分每次通話。構建：30 積分每次通話。

2026 年 5 月

5 月 26 日

  • 為 多圖生成 3D API 添加了 multi_view_thumbnails 引數。設定為 true ，任務會額外渲染四個方位檢視縮圖（正面、右側、背面、左側）並將它們返回於新的 thumbnail_urls 回應字段中。現有的 thumbnail_url 字段未更動。大約增加 3 秒的任務延遲。

5 月 22 日

5 月 13 日

  • 為 影象生成 3D API 添加了 multi_view_thumbnails 引數。設定為 true ，任務會額外渲染四個方位檢視縮圖（正面、右側、背面、左側）並將它們返回於新的 thumbnail_urls 回應字段中。現有的 thumbnail_url 字段未更動。大約增加 3 秒的任務延遲。

5 月 12 日

  • 為 重構網格 API 添加了 resize_longest_side 引數。調整模型的尺寸，使得最長的邊界框維度等於指定的公尺值。與 resize_height 和 auto_size 互斥。

5 月 11 日

5 月 7 日

  • 新的 可列印性分析 API：分析一個成功的 Meshy 任務 - 或任何 3D 模型 URL - 是否准備好 FDM 3D 列印。異步創建 + 流模式：POST 返回一個 task_id，然後 GET / SSE 流返回密封性、體積、孔和非流形邊緣指標。免費，不消耗積分。
  • 新的 可列印性修復 API：修復一個 3D 模型，讓其能夠進行 FDM 列印—修復非流形邊緣、退化面、孔及其他 topology 問題。接受現有的 Meshy input_task_id 或一個 model_url (.glb, .stl, .obj)。輸出格式與輸入一致。每個任務 10 積分。

2026 年 4 月

4 月 27 日

  • 將 consumed_credits 字段添加到每個 API 端點的所有任務響應中。顯示每個任務消耗的積分數。該字段出現在 PENDING、IN_PROGRESS 和 SUCCEEDED 狀態下的任務中。對於 FAILED 任務返回 0（失敗時自動退款積分）。參見 價格 了解每個端點所需的積分成本。

4 月 24 日

  • 添加 model_url 引數到 多色列印 端點。可以直接從 URL 或 Data URI 提交材質化的 3D 模型，而不是使用之前的 Meshy 任務 input_task_id。支持格式：.glb, .fbx。當同時提供 model_url 和 input_task_id 時，input_task_id 具有優先權。

4 月 21 日

  • 為 影象生成 3D 和 多圖生成 3D 端點新增 input_task_id 引數。在不提供 image_url / image_urls 的情況下直接引用已完成的文字生成影象或影象生成影象任務的輸出。當兩者都提供時，input_task_id 具有優勢。

4 月 20 日

4 月 14 日

4 月 12 日

  • 重構 API 文件：新增帶有相依字段的引數分組，行內預設、必需/棄用標籤和可展開的子導航，並將多圖、骨骼綁定和動畫分為獨立頁面。

2026 年 3 月

4 月 2 日

  • 在所有端點的 target_formats 引數中添加 3mf 格式支持（影象生成 3D, 文字生成 3D, 重構網格, 重新貼圖）。注意：3MF 是選擇性功能，必須顯式請求。
  • 新的 多色列印 API：將 3D 模型轉換為可多色列印的 3MF 格式。支持 1-16 色調色板並具備可配置的精度。一次任務 10 積分。

3 月 20 日

  • 停用 Meshy-4 AI 模型。所有使用 meshy-4 的 API 請求不再受支持。請遷移至 meshy-6 或 latest。
  • 增加 auto_size 和 origin_at 引數到 影象生成 3D, 多圖生成 3D, 文字生成 3D, 和 重構網格 端點。當 auto_size 啟用時，服務使用 AI 視覺估計現實世界高度並自動調整大小。origin_at 設定原點位置（bottom 或 center）。在 Remesh API 中，auto_size 與 resize_height 互斥。

3 月 17 日

2026 年 2 月

2 月 28 日

2 月 25 日

  • 在 影象生成 3D 和 多圖生成 3D APIs 中新增 image_enhancement 引數，供用戶選擇退出圖像優化並保持輸入的準確外觀。僅支持 meshy-6 和 latest。預設為 true。

2 月 20 日

  • 為 文字生成 3D 預覽 API 新增 model_type 引數以生成優化清潔多邊形的低多邊形網格。

2026 年 1 月

1 月 27 日

  • 增加了含有所有 API 端點的詳細故障模式文檔，包括常見的 HTTP 錯誤代碼 (400, 401, 402, 404, 422, 429) 和任務失敗的原因。這有助於開發者更好地理解和處理 API 錯誤。

1 月 26 日

  • 多圖生成 3D API 現在支持完整的 Meshy-6 網格生成。ai_model 引數現在接受 meshy-6，而 latest 解析到 Meshy 6。

1 月 22 日

  • 對 文字生成 3D 預覽 API（Meshy-6）已棄用 art_style。該引數為為舊版模型（Meshy-4 / Meshy-5）設計，將在未來版本中刪除。
  • 當 ai_model 為 meshy-4 時，對 文字生成 3D 和 影象生成 3D 已棄用 enable_pbr。該引數將在未來版本中刪除。
  • 為 Meshy-6 更新了 文字生成 3D 和 影象生成 3D APIs 中 should_remesh 引數的預設值。此引數現在默認為 false 中的 meshy-6, 如果未指定其他模型則為 true。

1 月 19 日

1 月 12 日

  • 為 影象生成 3D API 增加了新的 model_type 引數，以生成優化清潔多邊形的低多邊形網格。

2025 年 12 月

12 月 31 日

  • 啟動 API Playground，專為開發人員提供在 Meshy 網站上直接探索 API 參數和測試請求的空間。
  • 引入了文字生成影象 API 和 影象生成影象 API，支持以 AI 驅動從文本提示生成影象和影象編輯。兩個 API 任由使用 nano-banana 和 nano-banana-pro 型號，兼容多視圖生成。

12 月 22 日

  • 文字生成 3D API 回應中的 video_url 字段現在已棄用，並將在未來版本中刪除。

12 月 04 日

2025 年 11 月

11 月 24 日

  • 影象生成 3D 和 多圖生成 3D APIs 新增可選的 save_pre_remeshed_model 引數，並在請求預重構備份時暴露 model_urls.pre_remeshed_glb。

11 月 06 日

  • 文字生成 3D 細化 API 現在支持 ai_model = latest，解析為 Meshy 6 預覽。
  • 影象生成 3D API 現在默認為 Meshy-6-preview 貼圖，當 ai_model = latest 和 should_texture = true。
  • 多圖生成 3D API 現在支持 ai_model = latest，默認運行 Meshy-6-preview 貼圖，而網格生成保持為 Meshy-5。
  • 重新貼圖 API 增加了 latest 選項可用於 ai_model （Meshy-6-preview） 並在無指定時默認使用它。

11 月 04 日

2025 年 10 月

10 月 28 日

  • 新增 x-api-version 回應頭以標識當前 API 服務器版本。

10 月 20 日

10 月 01 日

  • 移除 text-to-voxel APIs

2025 年 9 月

9 月 23 日

  • 在 文字生成 3D API 中增加 ai_model 的 latest 選項以使用 Meshy 6 預覽。
  • 提供 Meshy-6-preview 生成任務的臨時 50% 折扣至 10 積分有效期至 2025 年 9 月 30 日。在折扣期結束後，Meshy-6-preview 任務費用將恢復到正常的 20 積分。

9 月 18 日

9 月 16 日

  • 在 影象生成 3D API 中增加 ai_model 的 latest 選項以使用 Meshy 6 預覽。

9 月 4 日

2025 年 8 月

8 月 18 日

8 月 13 日

2025 年 7 月

7 月 31 日

2025 年 6 月

6 月 25 日

  • 添加了 重新貼圖 API，允許用戶根據 Meshy 最新的基礎 AI 模型重新貼圖 3D 模型。

6 月 19 日

6 月 17 日

6 月 10 日

  • 重構網格 API 現在支持使用 Data URI 之於 model_url 引數的 base64 編碼 GLB 格式模型。

2025 年 5 月

5 月 20 日

5 月 15 日

2025 年 4 月

4 月 29 日

4 月 17 日

2025 年 3 月

3 月 28 日

3 月 14 日

3 月 06 日

  • 更新 API 生成任務的定價：
    • 文字生成 3D (預覽)：由每次通話 2 積分增至 5 積分
    • 文字生成 3D (細化)：由每次通話 5 積分增至 10 積分
    • 影象生成 3D：無紋理費用為 5 積分，具紋理費用為 15 積分
    • 文字生成紋理：由每次通話 5 積分增至 10 積分
    • 文字生成體素：保持每次通話 5 積分

2025 年 2 月

2 月 18 日

  • 添加了一個測試模式 API 金鑰，允許開發者在不消耗積分的情況下測試 API 集成。所有使用此金鑰的有效請求將返回相同的範例任務結果。

2 月 13 日

2 月 6 日

2025 年 1 月

1 月 23 日

1 月 14 日

  • 廢止了由 Meshy-3 AI 模型驅動的舊版文字生成 3D 和影象生成 3D APIs。

1 月 07 日

2024 年 12 月

12 月 19 日

  • 新增 重構網格 APIs，允許用戶將通過其他 Meshy APIs 生成的現有 3D 模型重新拓撲並導出到多種格式。
  • 將我們 APIs 的面數限制更新至高級用戶的 100-300,000 範圍。

12 月 12 日

  • 棄用了所有響應對象中的 model_url 屬性。
  • 將遺留的 Meshy-3 API 與最新的 Meshy-4 API 分開。

12 月 10 日

12 月 5 日

12 月 3 日

  • 外部 APIs 現在使用 /openapi 前綴。遺留路徑保持支持，但我們建議切換到新路徑。

2024 年 11 月

11 月 14 日