更新日誌

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

September 2026

Sep 4

  • 在動畫庫中新增了 GET /openapi/v1/animations/library：取得 Animation API 所接受的每一個預設動作——action_id、名稱、分類以及一張動態 GIF 預覽圖——並支援搜尋和分類篩選，讓你可以打造自己的動作選擇器，而不必去查閱參考表格。免費；不消耗積分。

Sep 3

  • Creative Lab Lamp API 的原型（prototype）階段現在會回傳一個 3D 模型：POST /prototype 會將概念圖轉換為一個中空的燈罩 GLB，並且原型任務物件在 image_urls 之外新增了 model_urls.glb 和 thumbnail_url。建置（build）階段現在只對該模型執行燈具處理器，並生成一個帶有光源固定底座的敞口燈罩。價格也隨之調整：原型階段為 30 積分，建置階段為 6 積分（先前分別為 6 和 30）。原型階段的 text 參數已被移除——image_url 現為必填項目。

9 月 1 日

  • 為 Multi-Image to 3D API 新增了 ultra_mode 參數：可在 ai_model 為 meshy-7（或 latest）時啟用 Ultra 生成模式，以獲得更高保真度的 geometry 和更精細的表面細節，額外花費 5 積分——這與 Image to 3D API 提供的 Ultra 處理流程相同，現在也可用於多視圖輸入。
  • 從 Image to 3D API 的 Smart Topology model_type 所記錄的 ai_model 取值中移除了 meshy-t1。Smart Topology 現在僅記錄 meshy-t2，新的整合應改用該值。Meshy T1 計畫棄用——如果你的整合目前傳送的是 ai_model: "meshy-t1"，請遷移至 meshy-t2。

2026年8月

Aug 28

  • 為 Studio 和 Enterprise 團隊新增了 Usage API：可透過程式化方式匯出歷史 API 任務使用情況——包括端點、狀態、時間戳記、執行每個任務的 API 金鑰，以及 consumed_credits——並支援標準分頁以及時間區間、端點和狀態篩選，便於成本追蹤與財務系統使用。

Aug 26

  • 動畫 API 現在支援接收 motion_task_id——可將透過 Text to Motion API 產生的動作片段套用到你已完成綁定骨骼（rig）的雙足角色上，作為預設 action_id 之外的替代方案。每個任務仍為 3 積分。

Aug 24

  • 擴充了 文字生成影象 和 影象生成影象 API 中 gpt-image-2 的 aspect_ratio 支援，新增 16:9 和 9:16。gpt-image-2 現已支援 1:1、16:9、9:16、3:2 和 2:3；4:3 和 3:4 仍不支援此模型。

Aug 21

  • 新增了 Text to Motion API：可根據自然語言描述產生角色動作片段，無需角色模型。選擇 prime mode（10 積分，輸出 FBX）可獲得最高品質，或選擇 swift mode（3 積分，輸出 BVH）以實現快速、經濟的產生，片段長度為 2–10 秒。

Aug 20

  • 為多色列印 API新增了 style 參數：選擇 realistic（預設）以獲得貼近 texture 的真實色彩，或選擇 cartoon 以獲得平面、統一的色彩區域並產生更小的 3MF。
  • 為每個 Creative Lab 原型端點新增了 remove_background 參數——Figure、Vinyl Figure、Brick Figure、Keycap、Keychain、Fridge Magnet 和 Lamp。設定 remove_background: true 即可獲得去除背景後的透明 RGBA PNG 原型圖像。

Aug 18

  • 在 Multi-Image to 3D API 中新增了 texture_image_urls 參數：可提供同一物體的 1–4 張圖片來指導貼圖生成，而不是使用單一的 texture_image_url。此功能需要 ai_model 為 meshy-7 或 latest，並且與 image_urls 相互獨立——這兩個清單可以包含不同的圖片以及不同數量的圖片。

Aug 17

  • 在 Text to Image API 和 Image to Image API 中新增了 remove_background 參數。將 remove_background 設為 true 即可取得已去除背景的透明 RGBA PNG 格式生成圖片。

Aug 13

  • 在 Text to 3D API 中新增了 ai_model: "meshy-7"：這是我們最新的 3D 生成模型，幾何體保真度高於 Meshy 6。它還在 preview 任務中引入了 ultra_mode 參數，可啟用 Ultra 生成模式，以額外 5 積分換取更精細的表面細節。若要使用 Meshy 7 進行紋理處理，請在 refine 任務中傳入 ai_model: "meshy-7"，或完全省略 ai_model。
  • 在 Text to 3D API 中新增了 Smart Topology model_type。設定 model_type: "smart-topology" 即可使用 meshy-t2 生成——擁有更乾淨的 topology、原生分離的部件、三角面輸出，以及可透過 target_polycount 設定的面數（100 到 15,000，預設 4,000）。Smart Topology 的 preview 費用為 5 積分，而非 20 積分；詳見 Pricing。現有的 model_type: "lowpoly" 現已 已棄用，但出於向後相容考量仍會繼續提供服務。

Aug 12

  • 在 Image to 3D API 中新增了 ai_model: "meshy-7"：這是我們最新的 3D 生成模型，相較於 Meshy 6 擁有更高保真度的幾何體。它還引入了 ultra_mode 參數，可啟用 Ultra 生成模式，帶來更精細的表面細節。
  • 在 Multi-Image to 3D API 中新增了 ai_model: "meshy-7"：這是 Meshy 的多視圖生成模型，會將你所有輸入視圖共同作為條件，並據此進行貼圖。
  • 在 Retexture API 中新增了 ai_model: "meshy-7"：這是我們最新的貼圖模型，相較於 Meshy 6 擁有更清晰的表面細節和更乾淨的 PBR 材質。它還引入了 multiview_image_urls 參數——提供同一物體的 1–4 張有序視圖，以驅動多視圖貼圖。

Aug 4

  • 將 Analyze Printability 和 Repair Printability 端點的 model_url 輸入支援擴展至 .glb、.gltf、.obj、.fbx、.stl（此前為 .glb、.stl、.obj）。修復功能會以輸入格式回傳修復後的 asset。

July 2026

Jul 27

  • 新增 Creative Lab — 方塊小人 API：將一張照片轉化為方塊風格的可收藏 3D 小人偶。採用與 Figure API 相同的兩階段工作流程——prototype（6 credits）產生風格化概念圖，build（30 credits）將其轉化為帶貼圖的 3D 模型，並輸出 GLB 和 OBJ + MTL 格式。完整費用明細請參見 Pricing。

Jul 22

  • 新增 Creative Lab — 鍵帽 API：將一張照片轉換為全彩客製化機械鍵盤鍵帽。採用兩階段工作流程 —— prototype（12 積分）產生成品鍵帽設計渲染圖，隨後 build（50 積分）將你所選定的設計（透過 candidate_id 指定）轉換為帶貼圖的 3D 鍵帽模型，輸出 GLB 與 OBJ 組合檔案，並按真實世界毫米比例匯出。目前支援標準 Cherry MX 1u 底座（cherry-mx-1x1-r1）；更多標準尺寸正在規劃中。完整費用明細請參見 Pricing。

Jul 21

  • 我們現在透過 影象生成 3D、多圖生成 3D、文字生成 3D Refine 和 重新貼圖 endpoint 上新增的 texture_resolution 參數（2k / 4k / 8k）支援 8K 基礎色貼圖。在 8k 下，PBR 貼圖將以 4K 產生，且不會產生 emission 貼圖。8K 貼圖產生費用為 15 積分（2k/4k 仍為 10）。請參閱 Pricing。
  • hd_texture 布林值已 deprecated，取而代之的是 texture_resolution——為保證向後相容，該參數仍然有效，且等同於 texture_resolution: "4k"。

Jul 20

  • 新增 Creative Lab — Vinyl Figure API：將一張照片轉換成大頭乙烯基收藏手辦 3D 模型。與 Figure API 採用相同的兩階段工作流程——prototype（6 積分）生成風格化概念圖，build（30 積分）將其轉換為帶紋理的 3D 模型，並輸出 GLB 和 OBJ + MTL 檔案。完整費用明細請參見 Pricing。

Jul 13

  • 在 Image to 3D API 中新增了 Smart Topology model_type，透過 ai_model 提供兩種模型：meshy-t1——目前的 low-poly 模型；以及 meshy-t2——一款擁有更簡潔 topology、原生分離部件、三角面輸出的新模型，並可透過 target_polycount 設定面數。在 smart-topology 下，meshy-t2 為預設模型。現有的 model_type: lowpoly 現已 deprecated，但為向後相容仍會繼續提供服務。

Jul 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 同時使用。

June 2026

Jun 17

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

Jun 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 的 Build 定價針對 Keychain、Fridge Magnet 和 Figure 更新為每次呼叫 30 積分（此前為 20 積分）。Lamp 保持不變，仍為 30 積分。Prototype 定價保持不變，仍為每張圖片 6 積分。完整明細請參閱 Pricing。

6月5日

Jun 1

  • 新增 Creative Lab APIs：一系列以產品為核心的 endpoint，可將一張來源照片（或文字 prompt）轉化為可 3D 列印的消費級產品。首發四款產品——Keychain、Fridge Magnet、Figure 和 Lamp。每款產品都遵循 prototype → build 兩階段工作流程，透過 input_task_id 串聯，服務於以產品為核心的 URL（/openapi/creative-lab/<product>/v1/...），並按產品獨立進行版本管理，使各產品可在各自獨立的版本線上演進。Prototype：每次呼叫 6 積分。Build：每次呼叫 30 積分。

2026年5月

May 26

  • 為 Multi-Image to 3D API 新增了 multi_view_thumbnails 參數。當設定為 true 時，該任務會額外渲染四個基本視角（正面、右側、背面、左側）的縮圖，並透過新增的 thumbnail_urls 回應欄位回傳。現有的 thumbnail_url 欄位保持不變。此功能會使任務延遲增加約 3 秒。

May 22

  • Remesh API 中的 Convert 與尺寸調整功能現已作為獨立的 Convert API 和 Resize API 端點提供。Remesh 上的 已棄用 參數將繼續保留以確保向後相容。

5月13日

  • 為 影象生成 3D API 新增了 multi_view_thumbnails 參數。當設定為 true 時，任務會額外算繪四個基本視角（正面、右側、背面、左側）的縮圖，並透過新增的 thumbnail_urls 回應欄位返回。現有的 thumbnail_url 欄位保持不變。此功能會使任務延遲增加約 3 秒。

5月12日

  • 為 Remesh API 新增了 resize_longest_side 參數。該參數會調整模型大小，使包圍盒最長維度等於指定的公尺數值。此參數與 resize_height 和 auto_size 互斥。

May 11

May 7

  • 新增 可列印性分析 API：分析一個已成功的 Meshy 任務——或任意 3D 模型 URL——以評估其是否滿足 FDM 3D 列印要求。採用非同步建立 + 串流取得模式：POST 請求會回傳 task_id，隨後 GET / SSE 串流會在狀態變為 SUCCEEDED 後回傳水密性、體積、孔洞及非流形邊等指標。免費，不消耗積分。
  • 新增 可列印性修復 API：修復 3D 模型以滿足 FDM 可列印性要求——修復非流形邊、退化面、孔洞及其他 topology 問題。可接受已有的 Meshy input_task_id 或 model_url（.glb、.stl、.obj）。輸出格式與輸入保持一致。每個任務消耗 10 積分。

2026年4月

4月27日

  • 為所有 API 端點的任務回應新增了 consumed_credits 欄位。該欄位顯示每個任務消耗的 credits 數量。對於處於 PENDING、IN_PROGRESS 和 SUCCEEDED 狀態的任務，都會回傳該欄位。對於 FAILED 狀態的任務，則回傳 0（失敗時會自動退還 credits）。各端點的 credit 費用請參見 價格。

4月24日

  • 為 多色列印 端點新增了 model_url 參數。可直接提交帶貼圖的 3D 模型（透過 URL 或 Data URI），而無需使用先前 Meshy 任務產生的 input_task_id。支援的格式：.glb、.fbx。若同時提供 model_url 和 input_task_id，則以 input_task_id 為優先順序。

Apr 21

  • 在 Image to 3D 和 Multi-Image to 3D 端點中新增了 input_task_id 參數。可直接引用已完成的文字生成影像或影像生成影像任務的輸出結果，而無需提供 image_url / image_urls。當兩者同時提供時，input_task_id 具有較高的優先順序。

Apr 20

Apr 14

Apr 12

  • 重構了 API 文件：新增了帶相依欄位的參數分組、行內預設值、必填/已棄用徽章、可展開的子導覽，並將 Multi-Image、Rigging 和 Animation 拆分為獨立頁面。

2026年3月

Apr 2

  • 為所有端點（Image to 3D、Text to 3D、Remesh、Retexture）的 target_formats 參數新增了 3mf 格式支援。注意：3MF 為可選項，必須明確請求才會啟用。
  • 新增 多色列印 API：格式轉換 3D 模型為多色 3MF 格式，用於 3D 列印。支援 1-16 色調色盤，並可設定精度。每個任務消耗 10 積分。

Mar 20

  • 已停用 Meshy-4 AI 模型。所有使用 meshy-4 的 API 請求將不再受支援。請遷移至 meshy-6 或 latest。
  • 已為 Image to 3D、Multi-Image to 3D、Text to 3D 和 Remesh 端點新增了 auto_size 和 origin_at 參數。啟用 auto_size 後，服務會使用 AI 視覺估算真實世界高度並自動調整模型尺寸。origin_at 用於設定原點位置（bottom 或 center）。在 Remesh API 中，auto_size 與 resize_height 互斥。

Mar 17

2026 年 2 月

Feb 28

  • 為 Image to 3D、Multi-Image to 3D、Text to 3D Refine 和 Retexture API 新增 remove_lighting 參數。該參數可從基礎顏色 texture 中移除高光和陰影，從而在自訂光照下獲得更乾淨的效果。僅在 meshy-6 和 latest 下受支援。預設值為 true。
  • Retexture 和 Text to 3D Refine API 現已支援將 meshy-6 作為 ai_model 參數值，以啟用完整的 Meshy 6 貼圖功能。

Feb 25

  • 為 Image to 3D 和 Multi-Image to 3D API 新增了 image_enhancement 參數，供希望退出輸入圖片優化、保留輸入內容原始外觀的使用者使用。僅支援 meshy-6 和 latest。預設值為 true。

Feb 20

  • 為 Text to 3D Preview API 新增了 model_type 參數，用於生成經過最佳化、多邊形更簡潔的低多邊形網格模型。

January 2026

Jan 27

  • 為所有 API 端點新增了詳細的 Failure Modes 文件，包括常見的 HTTP 錯誤代碼（400、401、402、404、422、429）和任務失敗原因。這有助於開發者更好地理解與處理 API 錯誤。

Jan 26

  • Multi-Image to 3D API 現已支援 Meshy-6 進行完整網格生成。ai_model 參數現在接受 meshy-6，latest 將解析為 Meshy 6。

Jan 22

  • 已棄用 Text to 3D Preview API（Meshy-6）中的 art_style 參數。該參數是為 Legacy 模型（Meshy-4 / Meshy-5）設計的，將在未來版本中移除。
  • 當 ai_model 為 meshy-4 時，已棄用 Text to 3D 和 Image to 3D API 中的 enable_pbr 參數。該參數將在未來版本中移除。
  • 更新了 Text to 3D 和 Image to 3D API 中 Meshy-6 的 should_remesh 參數預設值。若未指定，該參數在 meshy-6 中預設值為 false，在其他模型中預設值為 true。

Jan 19

Jan 12

  • 在 Image to 3D API 中新增了 model_type 參數，用於生成經過最佳化、擁有更整潔多邊形的 低多邊形 網格。

December 2025

Dec 31

  • 推出了 API Playground，這是一個專為開發者打造的空間，可直接在 Meshy 官網上探索 API 參數並測試請求。
  • 推出了 文字生成影像 API 和 影像生成影像 API，支援根據文字提示進行 AI 影像生成，以及根據參考影像進行影像編輯。這兩個 API 均支援 nano-banana 和 nano-banana-pro 模型，並可選擇啟用多視圖生成。

Dec 22

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

Dec 04

2025年11月

Nov 24

  • 影象生成 3D 和 多圖生成 3D API 新增了可選的 save_pre_remeshed_model 參數，並在請求了 重構網格 前備份時公開 model_urls.pre_remeshed_glb。

Nov 06

  • 文字生成 3D Refine API 現已支援 ai_model = latest，該值將解析為 Meshy 6 Preview。
  • 影象生成 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），並在未指定時預設使用該選項。

Nov 04

  • 重構網格 API 現在會為上傳的模型保留材質。
  • 重新貼圖 API 在啟用 enable_original_uv 選項時，現在會為上傳的模型保留材質。

2025 年 10 月

Oct 28

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

Oct 20

  • 在 重構網格 API 中新增了可選布林參數 convert_format_only，用於支援僅轉換輸入模型檔案的格式。
  • 在 骨架綁定任務物件 的回應中新增了 rigged_character_glb_url。

Oct 01

  • 移除 text-to-voxel API

2025 年 9 月

Sep 23

  • 在 Text to 3D API 中為 ai_model 新增了 latest 選項，用於呼叫 Meshy 6 Preview。
  • 目前對 Meshy-6-preview 生成任務提供臨時 50% 折扣，費用降至 10 積分，該優惠將持續至 2025 年 9 月 30 日。折扣期結束後，Meshy-6-preview 任務的費用將恢復至正常的 20 積分。

Sep 18

Sep 16

  • 為 Image to 3D API 中的 ai_model 新增了 latest 選項，用於使用 Meshy 6 Preview。

Sep 4

  • 將 Remesh 和 Retexture 的 model_url 輸入支援擴展至 .glb、.gltf、.obj、.fbx、.stl。

August 2025

Aug 18

Aug 13

  • Meshy 5 現已針對 Text to 3D 和 Image to 3D 穩定發布（ai_model：meshy-5），帶來了更出色的品質與一致性。

2025 年 7 月

Jul 31

2025年6月

Jun 25

  • 新增了 Retexture API，允許使用者基於 Meshy 最新的基礎 AI 模型對 3D 模型進行 Retexture。

Jun 19

Jun 17

Jun 10

  • Remesh API 現已支援透過 Data URI 在 model_url 參數中傳入 base64 編碼的 GLB 格式模型。

May 2025

May 20

5月15日

2025年4月

4月29日

  • 推出了 Multi-Image to 3D API，允許使用 meshy-5 AI 模型從 1 到 4 張輸入圖像生成 3D 模型。
  • 在 Text to 3D 和 Image to 3D API 中新增了 meshy-5 AI 模型選項。latest 標籤現在也指向 meshy-5。

Apr 17

  • 在 Image to 3D 和 Text to 3D Refine API 中新增了 texture_image_url 參數，允許使用者透過圖像來引導 texture 生成過程。

2025 年 3 月

Mar 28

  • 在 文字生成 3D 和 影象生成 3D API 中新增了 latest 參數，讓使用者能夠使用我們即將推出的先進 AI 模型，以獲得更優質的生成效果。

Mar 14

Mar 06

  • 更新了 API 生成任務的價格：
    • 文字生成 3D（Preview）：每次呼叫從 2 積分增加到 5 積分
    • 文字生成 3D（Refine）：每次呼叫從 5 積分增加到 10 積分
    • 影象生成 3D：現在無紋理為 5 積分，帶紋理為 15 積分
    • 文字生成紋理：每次呼叫從 5 積分增加到 10 積分
    • Text to Voxel：維持每次呼叫 5 積分不變

2025年2月

Feb 18

  • 新增了測試模式金鑰，允許開發者在不消耗積分的情況下測試 API 整合。所有使用該金鑰的有效請求都將回傳相同的範例任務結果。

Feb 13

  • 重大變更：

    • 免費層任務建立將於 March 20, 2025 結束。此後，所有 API 任務請求都將需要付費訂閱。為確保您的存取不受影響，我們建議在截止日期前完成升級。
    • 使用優惠碼 APIACCESS 即可享有 40% 折扣。感謝您一路以來的支持！

  • 新增了用於即時任務更新的 Server-Sent Events（SSE）串流端點：

Feb 6

  • 在 Image to 3D 和 Text to 3D Refine API 中新增了 texture_prompt 參數，允許使用者透過文字 prompt 來引導 texture 生成過程。

January 2025

Jan 23

Jan 14

  • 已棄用由 Meshy-3 AI 模型驅動的 Legacy 版文字生成 3D 和 影象生成 3D API。

Jan 07

December 2024

Dec 19

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

12月12日

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

12月10日

Dec 5

Dec 3

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

2024 年 11 月

Nov 14