更新日誌

查看所有 Meshy API 和外掛的最新功能與更新。

2026年6月

6月17日

  • 新增 API Playground 說明文件頁面：一個互動式主控台，無需撰寫程式碼即可試用各個端點，並複製對應的 cURL、Python 或 JavaScript 程式碼。在 Pro、Premium、Ultra、Studio 和 Enterprise 方案中可用。

6月15日

  • 新增 UV Unwrap API：為既有的 3D 模型自動產生高品質的 UV 展開——可作為貼圖前的前處理步驟，或在需要一份乾淨、無重疊的 UV 配置以供下游工具使用時呼叫。支援傳入 input_task_id（一個已完成的圖片生成 3D、文字生成 3D 或重構網格 任務）或 model_url（僅支援 .glb），回傳一個帶有全新 UV 座標的「UV 白模」。每次消耗 5 點數。支援 40,000 面以內的模型（更大請先呼叫 重構網格）；四邊形 / 多邊形網格會在 UV 產生時被三角化。

6月12日

  • 調整 Creative Lab API（Creative Lab API）的 Build 價格：鑰匙扣、冰箱磁鐵 和 手辦 的 Build 調整為 30 點數/次（先前為 20 點數）。燈具 維持 30 點數不變。Prototype 價格維持 6 點數/張不變。完整價格請參閱價格頁面。

6月5日

6月1日

  • 新增 Creative Lab API（Creative Lab APIs）：一組產品級端點，可將一張來源照片（或文字描述）轉換成可 3D 列印的消費級產品。首波推出四款產品 —— 鑰匙扣、冰箱磁鐵、手辦 和 燈具。每款都採用兩階段式 prototype → build 流程（透過 input_task_id 串聯），端點位於產品級 URL（/openapi/creative-lab/<product>/v1/...）下，每款產品都有獨立的版本線，可獨立演進。Prototype：6 點數/次。Build：30 點數/次。

2026 年 5 月

5月26日

  • 多圖生成 3D API 新增 multi_view_thumbnails 參數。當設定為 true 時，任務會額外算繪四個固定視角縮圖（front、right、back、left），並在新增的回應欄位 thumbnail_urls 中傳回。原有 thumbnail_url 欄位維持不變。會讓任務耗時增加約 3 秒。

5月22日

5月13日

  • 影象生成 3D API 新增 multi_view_thumbnails 參數。當設定為 true 時，任務會額外算繪四個固定視角縮圖（front、right、back、left），並在新增的回應欄位 thumbnail_urls 中傳回。原有 thumbnail_url 欄位維持不變。會使任務耗時增加約 3 秒。

5月12日

  • 重構網格 API 新增 resize_longest_side 參數。將模型縮放，使其最長邊界框尺寸等於指定值（單位：公尺）。與 resize_height 和 auto_size 互斥。

5月11日

5 月 7 日

  • 新增可列印性分析 API：對已成功完成的 Meshy 任務，或任意 3D 模型 URL 執行 FDM3D 列印可行性分析。非同步建立 + 串流模式：POST 會傳回 task_id，接著透過 GET / SSE 串流在 SUCCEEDED 時取得水密性、體積、孔洞與非流形邊等指標。免費，不消耗點數。
  • 新增可列印性修復 API：對 3D 模型進行 FDM可列印性修復——修復非流形邊、退化面、孔洞等拓撲問題。支援傳入既有 Meshy 任務的 input_task_id，或透過 model_url 上傳模型（.glb、.stl、.obj）。輸出格式與輸入格式一致。每次任務消耗 10 點數。

2026年4月

4月27日

  • 所有 API 端點的任務回應中新增 consumed_credits 欄位，顯示每個任務消耗的積分數。任務狀態為 PENDING、IN_PROGRESS 和 SUCCEEDED 時會傳回實際消耗的積分，FAILED 任務會傳回 0（失敗時積分會自動退還）。各端點的積分費用請參閱價格頁面。

4月24日

  • 為多色 3D 列印端點新增 model_url 參數。可直接透過 URL 或 Data URI 提交帶有紋理的 3D 模型，不再需要透過 input_task_id 參照上一個 Meshy 任務。支援的格式：.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 文件：新增參數分組與相依欄位顯示、行內預設值、必填/已棄用標籤、可展開子導覽，並將多影像生成 3D、綁定和動畫拆分為獨立頁面。

2026年3月

4月2日

3月20日

  • 停用 Meshy-4 AI 模型。所有使用 meshy-4 的 API 請求將不再受支援。請遷移至 meshy-6 或 latest。
  • 為圖像生成 3D、多圖像生成 3D、文字生成 3D 和 重構網格 端點新增 auto_size 和 origin_at 參數。啟用 auto_size 後，服務會使用 AI 視覺自動估算物件的真實高度並調整模型大小。origin_at 設定原點位置（bottom 或 center）。在重構網格 API 中，auto_size 與 resize_height 互斥。

3月17日

2026年2月

2月28日

2月25日

  • 為圖像生成 3D和多圖像生成 3D API 新增 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 的 art_style 參數（Meshy-6）。該參數僅適用於舊版模型（Meshy-4 / Meshy-5），將在後續版本中移除。
  • 已棄用文字生成 3D 和 圖片生成 3D API 中 ai_model 為 meshy-4 時的 enable_pbr 參數。該參數將在後續版本中移除。
  • 更新了 Meshy-6 在文字生成 3D和圖片生成 3D API 中 should_remesh 參數的預設值。如未指定，meshy-6 預設為 false，其他模型為 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 回應中的 video_url 欄位已棄用，後續版本將移除，請避免依賴該欄位。

12月4日

2025年11月

11月24日

11月6日

  • 文字生成 3D 精細化 API 現已支援 ai_model = latest，此標籤會解析為 Meshy 6 預覽模型。
  • 影像生成 3D API 在 ai_model = latest 且 should_texture = true 時，貼圖預設使用 Meshy-6-preview。
  • 多影像生成 3D API 現已支援 ai_model = latest，貼圖預設使用 Meshy-6-preview（模型生成仍以 Meshy-5 為基礎）。
  • 重新貼圖 API 新增 ai_model 的 latest 選項（Meshy-6-preview），未指定時預設使用此選項。

11月4日

  • 重構網格 API 現已支援在處理上傳模型時保留原始貼圖。
  • 啟用 enable_original_uv 選項時，重新貼圖 API 現在也會為上傳模型保留原始貼圖。

2025年10月

10月28日

  • 新增回應標頭 x-api-version，用於指出目前 API 伺服器版本。

10月20日

10月1日

  • 移除 文本生成体素 APIs

2025 年 9 月

9月23日

  • 在文字生成 3D API 中新增 ai_model 的 latest 選項，可使用最新的 Meshy 6 預覽 AI 模型。
  • Meshy-6-preview 生成任務暫時享 5 折優惠，僅需 10 點數，活動截至 2025 年 9 月 30 日。優惠期結束後，Meshy-6-preview 任務的費用將恢復為正常的 20 點數。

9月18日

9月16日

  • 在圖像生成 3D API 中新增 ai_model 的 latest 選項，可使用最新的 Meshy 6 預覽 AI 模型。

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日

  • 引入了自動骨骼綁定與動畫 API，讓使用者能夠自動為 3D 模型進行骨骼綁定並製作動畫。了解骨骼綁定 和 動畫。

2025年4月

4月29日

4月17日

2025 年 3 月

3月28日

3月14日

3月6日

  • 更新了 API 生成任務的計價：
    • 文字生成 3D（預覽）：每次呼叫從 2 點數增加到 5 點數
    • 文字生成 3D（最佳化）：每次呼叫從 5 點數增加到 10 點數
    • 圖像生成 3D：無紋理為 5 點數，有紋理為 15 點數
    • 文字生成紋理：每次呼叫從 5 點數增加到 10 點數
    • 文字生成體素：每次呼叫維持在 5 點數

2025年2月

2月18日

  • 新增了一個測試模式 API 金鑰 msy_dummy_api_key_for_test_mode_12345678，允許開發人員在不消耗點數的情況下測試 API 整合。使用此金鑰的所有有效請求都會傳回相同的範例任務結果。

2月13日

2月6日

2025年1月

1月23日

1月14日

  • 棄用由 Meshy-3 AI 模型支援的舊版文字生成 3D 和圖片生成 3D API。

1月7日

2024年12月

12月19日

  • 新增了重構網格 API，允許使用者對其他 Meshy API 產生的現有 3D 模型進行重構網格，並匯出為各種格式。
  • 為進階使用者更新了我們 API 的多邊形數量限制，範圍為 100-300,000。

12月12日

  • 棄用了所有回應物件中的 model_url 屬性。
  • 將舊版Meshy-3 API與最新的Meshy-4 API分離。

12月10日

12月5日

12月3日

  • 外部 API 現在使用 /openapi 前綴。舊版路徑仍受支援，但我們建議切換到新路徑。

2024年11月

11月14日