更新日誌

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

2026年7月

7月27日

  • 新增 創意工坊 — 方塊小人 API：把一張照片變成方塊（積木）風格的可收藏 3D 小人。與 Q 版手辦 API 相同的兩段式流程 —— prototype（6 積分）生成風格化概念圖，build（30 積分）再把概念圖轉成帶貼圖的 3D 模型，輸出 GLB 與 OBJ + MTL。完整定價見 Pricing。

7月21日

  • 現已支援 8K 基礎色貼圖：在 影象生成3D、多影象生成3D、文字生成3D精細化 和 重新貼圖 端點上新增了 texture_resolution 參數（2k / 4k / 8k）。在 8k 下，PBR 貼圖以 4K 生成，且不生成自發光貼圖。8K 貼圖生成消耗 15 積分（2k/4k 仍為 10 積分）。詳見 Pricing。
  • hd_texture 布林參數已棄用，建議改用 texture_resolution——為保持向後相容，它仍然有效，且等同於 texture_resolution: "4k"。

7月20日

  • 新增 創意工坊 — 方頭手辦 API：把一張照片變成方頭風格的可收藏搪膠 3D 手辦。與 Q 版手辦 API 相同的兩段式流程 —— prototype（6 積分）生成風格化概念圖，build（30 積分）再把概念圖轉成帶貼圖的 3D 模型，輸出 GLB 與 OBJ + MTL。完整定價見 Pricing。

7月13日

  • 為 影象生成3D API 新增 Smart Topology model_type，通過 ai_model 提供兩個模型：meshy-t1——當前的低面數模型；meshy-t2——全新模型，拓撲更簡潔、原生分件、僅輸出三角面，並可通過 target_polycount 指定目標面數。在 smart-topology 下 meshy-t2 為預設值。原有的 model_type: lowpoly 現已棄用，但仍繼續服務流量以保持向後相容。

7月7日

  • 為 影象生成影象 API 新增 aspect_ratio 參數，可在編輯時控制輸出影像的寬高比。nano-banana 系列模型支持 1:1、16:9、9:16、4:3、3:4，gpt-image-2 支持 1:1、3:2、2:3。可選參數，默認為 1:1，且不能與 generate_multi_view 同時使用。

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 面以內的模型（更大請先調用 Remesh）；四邊形 / 多邊形網格會在 UV 生成時被三角化。

6月12日

  • 調整 創意工坊 API（Creative Lab API）的 Build 定價：鑰匙扣、冰箱貼 和 Q 版手辦 的 Build 調整為 30 積分/次（此前為 20 積分）。燈罩 保持 30 積分不變。Prototype 定價保持 6 積分/張不變。完整價目詳見定價頁面。

6月5日

6月1日

  • 新增 創意工坊 API（Creative Lab APIs）：一組產品級端點，把一張源照片（或文字描述）變成可 3D 列印的消費級產品。首發四款產品 —— 鑰匙扣、冰箱貼、Q 版手辦 和 燈罩。每款都採用兩段式 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日

  • Remesh API 中的格式轉換和尺寸調整功能現已拆分為獨立的 轉換 API 和 調整大小 API 端點。Remesh 上已棄用的相關參數將繼續正常工作，以保持向後相容。

5月13日

  • 影象轉3D API 新增 multi_view_thumbnails 參數。當設置為 true 時，任務會額外渲染四個固定視角縮略圖（front、right、back、left），並在新增的響應字段 thumbnail_urls 中返回。原有 thumbnail_url 字段保持不變。會讓任務花費增加約 3 秒。

5月12日

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

5月11日

5月7日

  • 新增可列印性分析 API：對已成功的 Meshy 任務，或任意 3D 模型 URL 運行 FDM 3D 列印可行性分析。Async create + stream 模式：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日

  • 為所有端點添加了 3mf 格式支持（影象生成3D、文字生成3D、Remesh、重新貼圖）的 target_formats 參數。注意：3MF 格式需要明確請求，不會預設生成。
  • 新增多色列印 API：將 3D 模型轉換為多色 3MF 格式，支持 1-16 色調色板和可配置精度。每次調用 10 積分。

3月20日

  • 下線 Meshy-4 AI 模型。所有使用 meshy-4 的 API 請求將不再受支持。請遷移至 meshy-6 或 latest。
  • 為影象生成3D、多影象生成3D、文字生成3D 和 Remesh 端點新增 auto_size 和 origin_at 參數。啟用 auto_size 後，服務使用 AI 視覺自動估算物體的真實高度並調整模型大小。origin_at 設置原點位置（bottom 或 center）。在 Remesh 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日

  • Remesh 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日

  • 為文字生成3D和影象生成3D API 添加了 latest 參數，以便使用我們即將推出的高級AI模型，從而提高生成質量。

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日

  • 重大變更：

    • 免費套餐的任務創建功能將於 2025年3月20日 結束。之後，所有API任務請求將需要付費訂閱。為確保您的服務不會中斷，我們建議在截止日期前升級。
    • 使用優惠碼 APIACCESS 可享 40% 折扣。感謝您的支持！

  • 為即時任務更新添加了伺服器發送事件 (SSE) 串流端點：

2月6日

2025年1月

1月23日

1月14日

  • 棄用了由 Meshy-3 AI 模型支持的舊版文字生成3D和影象生成3D API。

1月7日

2024年12月

12月19日

  • 添加了Remesh 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日