更新日誌

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

2026年9月

Sep 3

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

Sep 1

  • 在 Multi-Image to 3D API 中新增了 ultra_mode 參數：在 ai_model 為 meshy-7（或 latest）時啟用 Ultra 生成模式，可獲得更高保真度的 geometry 和更精細的表面細節，額外花費 5 credits —— 這與 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 團隊新增了使用情況 API：以程式化方式匯出歷史 API 任務使用情況——包括 endpoint、狀態、時間戳記、執行每個任務的 API 金鑰，以及 consumed_credits——並支援標準的分頁以及按時間範圍、端點和狀態進行篩選，方便成本追蹤與財務系統使用。

Aug 26

  • Animation API 現在支援 motion_task_id——可將透過文字生成動作 API 生成的動作片段套用到你的雙足骨架綁定角色上，作為預設 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（預設）以獲得貼圖精確的顏色，或選擇 cartoon 以獲得扁平、均勻的色塊區域和更小的 3MF 檔案。
  • 為每個 Creative Lab 原型 endpoint 新增了 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 參數，只需額外花費 5 積分即可啟用 Ultra 生成，獲得更精細的表面細節。要使用 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

  • 為 可列印性分析 和 可列印性修復 端點擴充了 model_url 輸入支援，新增 .glb、.gltf、.obj、.fbx、.stl（先前僅支援 .glb、.stl、.obj）。修復功能會以輸入格式傳回修復後的資產。

2026 年 7 月

Jul 27

  • 全新 Creative Lab — 方塊小人 API：將照片轉換為方塊風格的可收藏 3D 小人偶。採用與 Q 版手辦 API 相同的兩階段工作流程 —— prototype（6 積分）產生風格化概念圖像，build（30 積分）將其轉換為帶貼圖的 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）；更多標準尺寸正在規劃中。完整費用明細請參見 價格。

Jul 21

  • 我們現在透過一個新增的 texture_resolution 參數（2k / 4k / 8k）在 影象生成 3D、多圖生成 3D、文字生成 3D Refine 以及 重新貼圖 各端點上支援了 8K 基礎色紋理。在 8k 檔位下，PBR 貼圖將以 4K 解析度生成，且不會生成 emission 貼圖。8K 紋理生成費用為 15 積分（2k/4k 仍為 10 積分）。詳見 價格。
  • hd_texture 布林參數已棄用，取而代之的是 texture_resolution —— 出於向後相容考慮，該參數仍然有效，等同於 texture_resolution: "4k"。

Jul 20

  • 新增 Creative Lab — Vinyl Figure API：將照片轉換為大頭 Vinyl 收藏公仔 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 —— 目前的低多邊形模型，以及 meshy-t2 —— 一個新模型，具有更簡潔的 topology、原生分離的部件、三角形輸出，並可透過 target_polycount 設定面數。meshy-t2 是 smart-topology 下的預設模型。現有的 model_type: lowpoly 現已棄用，但仍會繼續處理請求以維持向下相容。

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 展開 API：為現有 3D 模型生成高品質的 UV 佈局——這是材質貼圖之前的必要步驟，也適用於任何需要為下游工具準備乾淨、無重疊 UV 佈局的情境。可傳入 input_task_id（已完成的 影象生成 3D、文字生成 3D 或 重構網格 任務）或 model_url（僅限 .glb），並傳回一個具有全新 UV 座標的「UV 白模」。每次呼叫消耗 5 點積分。支援最多 40,000 面的網格（若面數更多，請先執行 重構網格）；四邊形和多邊形網格會在 UV 生成過程中被三角化。

Jun 12

  • 已將 Creative Lab API 的 Build 定價更新為每次呼叫 30 積分，適用於 Keychain、Fridge Magnet 和 Figure（此前為 20）。Lamp 保持不變，仍為 30 積分。Prototype 定價保持不變，仍為每張圖片 6 積分。完整明細請參見 Pricing。

Jun 5

Jun 1

  • 新增 Creative Lab API：一組以產品為範圍的端點，可將一張來源照片（或文字 prompt）轉換為可 3D 列印的消費類產品。首批上線四款產品——Keychain、Fridge Magnet、Figure 和 Lamp。每款產品都遵循兩階段的 prototype → build 工作流程，透過 input_task_id 串聯，並在以產品為範圍的 URL（/openapi/creative-lab/<product>/v1/...）下提供服務，每個產品擁有獨立的版本控制，便於各產品沿各自獨立的版本線演進。Prototype：每次呼叫 6 積分。Build：每次呼叫 30 積分。

May 2026

May 26

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

May 22

  • Remesh API 中的 convert 和 resize 功能現已作為獨立的 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月

Apr 27

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

Apr 24

  • 為 Multi-Color Print 端點新增了 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、骨骼綁定和 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 互斥，不能同時使用。

3月17日

2026 年 2 月

2月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 參數，用於生成經過最佳化、擁有更簡潔多邊形的 low-poly 網格。

2026年1月

Jan 27

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

Jan 26

  • 多圖生成 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 時，已棄用 文字生成 3D 和 影象生成 3D API 中的 enable_pbr 參數。該參數將在未來的版本中移除。
  • 更新了 文字生成 3D 和 影象生成 3D API 中 Meshy-6 的 should_remesh 參數的預設值。如果未指定，該參數在 meshy-6 中現在預設為 false，在其他模型中預設為 true。

1月19日

1月12日

  • 在 影象生成 3D API 中新增了 model_type 參數，用於生成經過最佳化、多邊形更精簡的低多邊形網格。

2025年12月

12月31日

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

Dec 22

  • Text to 3D API 回應中的 video_url 欄位現已 deprecated，並將在未來版本中移除。

Dec 04

2025年11月

Nov 24

  • Image to 3D 和 Multi-Image to 3D API 新增了可選參數 save_pre_remeshed_model，並在請求了 Remesh 前備份時暴露 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

  • Remesh API 現在會為上傳的模型保留貼圖。
  • 啟用 enable_original_uv 選項後，Retexture API 現在會為上傳的模型保留貼圖。

2025 年 10 月

Oct 28

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

Oct 20

  • 為 Remesh 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 模型進行重新貼圖。

Jun 19

6月17日

6月10日

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

2025年5月

5月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 參數，允許使用者透過圖片來引導貼圖生成過程。

2025 年 3 月

Mar 28

  • 在 Text to 3D 和 Image to 3D API 中新增了 latest 參數，可用於存取我們即將推出的先進 AI 模型，以提升生成品質。

Mar 14

  • Text to Texture API 現已支援在 model_url 參數中透過 Data URI 傳遞 base64 編碼的模型，用法與 Image to 3D API 中的 image_url 類似。

Mar 06

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

2025年2月

Feb 18

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

Feb 13

  • 重大變更：

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

  • 新增了用於即時任務更新的 Server-Sent Events (SSE) 串流 endpoint：

Feb 6

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

January 2025

Jan 23

Jan 14

  • 已淘汰由 Meshy-3 AI 模型驅動的 Legacy Text to 3D 和 Image to 3D API。

Jan 07

December 2024

Dec 19

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

Dec 12

  • 已淘汰所有回應物件中的 model_url 屬性。
  • 已將 Legacy Meshy-3 API 與最新的 Meshy-4 API 分離。

Dec 10

Dec 5

Dec 3

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

2024 年 11 月

Nov 14