lowpoly 將於 2026年10月30日 下線。 請在這些日期前切換模型，以免請求出錯。 查看所有棄用資訊

更新日誌

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

更喜歡即時動態嗎？最新的條目也會顯示在開發者平台總覽頁面中。

November 2026

Nov 5

  • 全新 Relief API：將一張照片轉換為浮雕 3D 模型（GLB 和 STL）以及 16 位元灰階深度圖，適用於 3D 列印、雷射雕刻和 CNC 雕刻。可選參數可設定尺寸、雕刻 mode 和深度、底座、彎曲度以及 mesh 解析度，should_generate_model: false 則僅回傳深度圖。每個任務 20 積分。

Nov 3

  • 在 Image to 3D 和 Multi-Image to 3D 中新增了 texture_model，讓你可以在同一個任務中選擇 texture 模型和 mesh。Image to 3D 支援 Meshy 7（meshy-7）、Meshy N1（meshy-n1）以及 Meshy 6 Lite（meshy-6-lite），可搭配任意 ai_model。Multi-Image to 3D 支援多視角 texture 模型，即 Meshy 7 和 Meshy N1。每個 texture 模型都保留各自的限制；詳見 Models。任務費用為其 ai_model 對應的僅 mesh 價格，加上對應 texture 解析度下的 Retexture 價格；詳見 Pricing。不帶 texture_model 的請求將按原有方式運作。
  • 在 Text to 3D 的 refine 階段新增了 ai_model: "meshy-n1"。如果未提供 texture_image_url，Meshy N1 會使用 Meshy 7.1 或 latest 版本 preview 所儲存的參考影像進行 texture 處理。其他 preview 版本則需要提供 texture_image_url。使用 Meshy N1 進行 refine 的費用為 10 積分。

Nov 2

  • 在 Retexture API 中新增了 ai_model: "meshy-n1"。Meshy N1 可根據一到四張參考圖生成 2K 基礎色紋理。當使用多張圖片時，第一張為正視圖，其餘圖片的順序不影響結果，這一點與 Meshy 7 相同。它不接受文字 prompt，不生成 PBR 貼圖或 4K、8K 紋理，並可為最多 7,999,999 面的 3D 模型生成紋理。一個任務消耗 10 積分，與 2K 重新貼圖相同；詳見 Pricing。latest 仍指向 Meshy 7。

2026年10月

Oct 30

  • Text to 3D 和 Image to 3D 上部分 Meshy T1 請求（model_type: "lowpoly" 或 ai_model: "meshy-t1"）現在運行在 Smart Topology 上，其餘請求將回傳 400。model_type: "smart-topology" 配合 ai_model: "meshy-t2.5" 取代了 T1。自2026年11月30日起，所有 T1 請求都將回傳 400。Deprecations 列出了仍可運行的請求。
  • Auto Split API 新增了一個可選參數 keep_texture。當設定 keep_texture: true 時，帶紋理的模型的每個部分都會保留紋理，任務會在 texture_urls 中回傳紋理貼圖，並附帶一個與 OBJ 配套的 mtl 檔案。如果不設定該參數，拆分方式與之前相同。保留紋理的拆分耗時約為原來的兩倍，費用仍為 10 積分。input_task_id 現在也接受 Text to 3D 的 refine 和重新貼圖任務。

Oct 26

  • 新增 Deprecations 頁面：展示每個 3D 生成模型的生命週期（活躍、Legacy、已棄用或已停用）及其停用日期和推薦替代方案，以及每次 API deprecation 的歷史記錄，還有目前仍在服務中的已棄用參數。API 頁面上的停用橫幅現已連結到該頁面。

Oct 23

  • 在 Rigging 中將 texture_image_url 標記為已棄用。Meshy 會使用 model_url 檔案中嵌入的紋理，或輸入任務自帶的紋理，因此當模型自帶紋理時請不要傳入該參數。如果你傳入了該參數，該圖像將成為綁定後模型的唯一紋理，並且模型會失去其 PBR 貼圖。

Oct 21

  • 為 Studio 和 Enterprise 團隊的所有建立任務的端點（Creative Lab 端點除外）新增了 X-Meshy-Metadata 請求標頭。你可以用自己的鍵值對（例如 user=alex@example.com,team=fab）標記任務，並在 Usage 記錄的 metadata 欄位中讀取它們。詳見 Metadata。

Oct 19

  • 在 Keychain 和 Fridge Magnet 建置任務中，export_resolution 現在最高可接受 512，而不再是之前的 2048。512 是建置 geometry 所依據的深度圖的解析度，因此任何高於該值的設定都只是在既有的取樣點之間插入額外的頂點，從而產生描述同一表面但體積更大的檔案。512 同時也是預設值，因此從未設定過 export_resolution 的呼叫端不會受到影響。現在，設定高於 512 的值會在建立任務時直接回傳 400，而不是被接受。尤其是 2048，總是會超出產生器的處理時限，在任務啟動後才失敗。如果你將 export_resolution 設定為高於 512 的值，請刪除該參數或將其設為 512。

Oct 15

  • 在 Image to 3D 和 Text to 3D API 中新增了 ai_model: "meshy-t2.5"：這是最新的 Smart Topology 模型，為遊戲資產提供更銳利的細節。請搭配 model_type: "smart-topology" 使用；輸出僅為三角面，target_polycount 接受 100 到 30,000 之間的值（預設 15,000）。定價與 meshy-t2 相同；詳見 Pricing。當設定了 model_type: "smart-topology" 而未指定 ai_model 時，現在預設使用該模型；如需繼續使用 Meshy T2，請設定 ai_model: "meshy-t2"。Multi-Image to 3D 不支援 meshy-t2.5。

Oct 14

  • 當 model_url 為 http 或 https 的 URL 時，現在支援最大 400 MB 的檔案，高於此前的 100 MB，適用於 重新貼圖、重構網格、Rigging、格式轉換、尺寸調整、UV 展開、多色列印、可列印性分析 以及 可列印性修復。data: URI 仍維持 100 MB 的限制。超過 100 MB 的 GLB、glTF、FBX 或 OBJ 檔案最多只能包含 10,000,000 個面（多色列印為 8,000,000 個），按三角形計數；超過此數量的檔案將返回 400。超過 100 MB 時，FBX 檔案必須是 7.1 或更高版本的二進位 FBX，且 GLB 或 glTF 檔案不得使用 Draco 壓縮。檔案會在建立請求返回之前被下載完成，因此對於較大的檔案請預留最多 120 秒的時間（參見 Task Lifecycle）。100 MB 及以下的檔案行為保持不變，定價也不受影響。
  • 可列印性分析 現在對於屬於其他帳戶的 input_task_id，會返回 404 以及與 id 不存在時相同的回應內容，而不再返回 403。對於屬於你自己的任務，或屬於你所在工作區中隊友的任務，行為保持不變。

Oct 12

  • USDZ 檔案現在使用公尺為單位，因此模型在 AR Quick Look、Reality Composer、Blender 和其他 USD 檢視器中會以真實大小開啟。Text to 3D、Image to 3D、Multi-Image to 3D、Retexture、Remesh、Convert、Resize 和 Auto Split 任務的 model_urls 中的 usdz 檔案現在宣告 metersPerUnit = 1。此前它宣告的是英尺（metersPerUnit = 0.3048），但其座標實際以公尺為單位，因此模型顯示為實際大小的 30.48%。如果你之前透過將 USDZ 檔案縮放 3.28 倍來進行補償，請針對此日期之後建立的任務移除該縮放操作。此前任務產生的檔案將維持其目前單位不變，Rigging 和 Animation 的 USDZ 檔案不受此變更影響。

10月10日

  • meshy-5 已停用。向 文字生成 3D、影象生成 3D、多圖生成 3D 或 重新貼圖 傳送 ai_model: "meshy-5" 的請求現在會傳回 400，提示資訊為 ai_model meshy-5 has been retired; use meshy-6-lite。請切換至 meshy-6-lite，它接受相同的參數，積分消耗也相同。你之前使用 meshy-5 產生的模型仍然可用，且在不設定 ai_model 的情況下對 meshy-5 的 preview 進行 refine 仍然有效。
  • 文件中現已將 .webp 列為支援的圖片輸入格式，與 .jpg、.jpeg 和 .png 一樣，適用於 影象生成 3D、多圖生成 3D、影像生成影像、重新貼圖（image_style_url）以及 文字生成 3D Refine（texture_image_url）。它同時支援公開 URL 與 Data URI（data:image/webp;base64,...）兩種形式。現有的整合不受影響，Pricing 也保持不變。
  • 取得餘額 現在還會傳回 monthly_credits、permanent_credits 和 monthly_resets_at，讓你可以查看餘額中有多少將在下次重新整理時到期。balance 本身保持不變。

10 月 6 日

  • 可列印性分析和可列印性修復現在可以按照您計劃列印的尺寸檢查壁厚。傳送 printer_type、列印尺寸，或兩者都傳送。可列印性分析會在 printability.thin_walls 中回報薄壁，可列印性修復會在需要時將其加厚，並且可以複用透過 input_task_id 傳入的可列印性分析任務的印表機和尺寸。不使用這些欄位的整合行為維持不變，Pricing 也不受影響。

2026年9月

Sep 29

  • 舊版 /v2/text-to-3d 路徑（不帶 /openapi 前綴）已 deprecated。目前仍可正常使用，但將在未來版本中移除。請切換到 /openapi/v2/text-to-3d，它接受相同的請求並回傳相同的回應。舊版路徑的回應現在會帶有 Deprecation 請求標頭，以及指向新路徑的 Link 請求標頭。

Sep 28

  • API 回應現在包含速率限制請求標頭，包括 Retry-After，用於告知你在重試或再次輪詢前應等待多長時間。
  • 多色列印 新增了一個 printer_brand 參數，可將相符的切片軟體預設寫入 3MF 檔案，使該檔案在 Anycubic、Creality、Elegoo、Flashforge、Prusa、Qidi、Snapmaker 和 AnkerMake 印表機以及 Bambu Lab（預設選項）上開啟後即可直接列印。該頁面現在也記錄了 max_depth 參數。

Sep 18

  • 為 影象生成 3D、 多圖生成 3D 和 文字生成 3D 新增了 meshy-7.1 作為 ai_model 的可選值：參數與積分消耗與 meshy-7 相同，但幾何細節更高。latest 現在會解析為 meshy-7.1；meshy-7 已棄用，但仍可照常使用。
  • 為上述相同的 API 新增了 geometry_resolution（standard / 2k / 4k），用以取代現已棄用的 ultra_mode（ultra_mode: true 仍然可用，等同於 "2k"）。4k 需要 Meshy 7.1（meshy-7.1 或 latest），且 不適用於多圖生成 3D，其額外消耗的積分與 2k 相同，均為 5 積分。

Sep 16

  • Auto Split API 現在接受帶有 texture 的 input_task_id。此前它會返回 400 拒絕請求，這意味著需要先以 should_texture: false 再次生成同一個 mesh 才能進行拆分。拆分會切割 geometry 並重建每個部件的表面，因此輸入的 texture 不會被保留，結果是一個未貼圖的模型，每個部件只有一種純色。這在以往的每一次拆分中都是如此，並未發生變化。
  • meshy-5 將於 2026 年 10 月 10 日 停用。它已不再作為 Text to 3D、Image to 3D、Multi-Image to 3D 或 Retexture 的 ai_model 取值出現在文件中，10 月 10 日之後，傳送 ai_model: "meshy-5" 的請求將返回錯誤。
  • 共享的測試模式 API key 已停用；仍然傳送該 key 的請求現在會返回 401 Unauthorized。如果你曾將其複製到程式碼或 CI 中，請從 API Keys 頁面取得你自己的 key 來替換它。那個 key 無論輸入什麼都會始終返回相同的範例模型，因此它從未真正展示過某個請求實際會產生什麼結果。要在正式建置之前查看 API 的返回結果，請使用開發者平台中的 Playground，它會在你的瀏覽器中執行一次真實的任務。在沒有 API 存取權限的方案上，它會在不使用 API 金鑰的情況下執行 Image to 3D，並像其他任務一樣使用你帳戶的積分。

Sep 15

  • 在 文字生成影像 和 影像生成影像 API 的文件化 ai_model 值中新增了 gpt-image-2-5-flare 和 gpt-image-2-5-sunburst。這些是 OpenAI GPT Image 2.5 系列檔位，定價與 gpt-image-2 相同（文字生成影像：9 積分；影像生成影像：12 積分）。
  • GPT Image 模型（gpt-image-2、gpt-image-2-5-flare、gpt-image-2-5-sunburst）現在除了支援 1:1、16:9、9:16、3:2 和 2:3 之外，在 文字生成影像 和 影像生成影像 API 上也支援 4:3 和 3:4 寬高比。

Sep 14

  • 影像生成影像 API 現在接受 input_task_id，因此你可以直接從已完成的文字生成影像或影像生成影像任務進行串接，而無需將其輸出 URL 複製到 reference_image_urls 中。

Sep 11

  • 行為變更：對已處於 IN_PROGRESS 狀態的任務執行 DELETE 操作現在會被拒絕，並回傳 409 Conflict，任務將繼續執行。此前該操作會回傳 200 OK，停止工作程序並捨棄結果，但由於只有 PENDING 狀態的任務才可退款，所以積分仍會被扣除。這樣一來，這次呼叫既消耗了模型資源又扣除了積分，而回應中卻沒有任何提示。如果你的整合是透過刪除任務來取消任務，請注意：工作程序已經開始執行的任務是無法取消的。請等待任務變為 SUCCEEDED、FAILED 或 CANCELED 狀態後再刪除。PENDING 狀態的任務仍會依照先前的方式被刪除並退款，處於終止狀態的任務也仍會被刪除。此變更適用於 /openapi 下的所有任務系列。詳見 Errors。
  • 在 Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture API 文件中的 ai_model 可選值中新增了 meshy-6-lite。它是 meshy-5 的後繼版本：參數相同，積分消耗也相同（mesh 為 5 積分，含 texture 為 15 積分，retexture 為 10 積分）。
  • meshy-5 現已在所有接受該參數的 API 中被標記為已棄用。它仍可正常使用，你的請求和帳單都不會受到任何影響，但在未來的版本中將不再接受新的請求。如果你的整合發送了 ai_model: "meshy-5"，請遷移至 meshy-6-lite。

Sep 9

  • 新增 Auto Split API：可將未貼圖的 Meshy 6 或 Meshy 7 模型拆分為可獨立列印的部件。可自動拆分、依你命名的部件拆分（by_parts），或依顏色區域拆分（by_color），並可選擇加入榫卯連接件與薄壁補強。每個部件都會作為獨立物件匯出為 glb、obj、fbx、usdz、blend 或 3mf 格式，可選擇以已組裝狀態或在列印平台上排列（layout）。每個任務需花費 10 積分。

Sep 7

  • 在 Creative Lab Keychain API 的原型階段新增了 name_text 參數：可在鑰匙扣上雕刻最多 10 個字元的名字，與網頁應用程式提供的個人化訂製功能相同。建置階段會自動繼承該雕刻內容，而且原型任務物件現在會回傳 name_text，方便你在建置前確認具體文字內容。name 仍然只是一個僅供顯示用的任務標籤，不會被雕刻。

9 月 5 日

  • 新增 Creative Lab Fidget Pixel API：分兩個階段將照片轉換為可多色 3D 列印的像素藝術指尖玩具板。POST /prototype（6 積分）將照片像素化為像素藝術圖像。透過傳入 type 為 person 或 other 來選擇像素化風格。POST /build（30 積分）將其取樣到 16 或 32 網格上，並將每個像素轉換為可互鎖的 square 或 hex 拼塊，最終以一個帶有顏色標記的 3MF 檔案交付，用於多材料列印。拼塊的 geometry 可透過 piece_size_mm、color_count 和 piece_height_mm 進行調整。

Sep 4

  • 在 動畫庫 中新增了 GET /openapi/v1/animations/library：取得 動畫 API 支援的每一個預設動作（action_id、名稱、分類，以及一個動畫 GIF 預覽），並支援搜尋和分類篩選，這樣你就可以建立自己的動作選擇器，而不必查閱參考表格。免費；不消耗積分。
  • 新增了 Creative Lab Collapsible Fidget API：將一張照片轉換為可直接列印、無需組裝的可折疊減壓玩具（collapsible fidget toy），其中主體的輪廓會變成嵌套的同心環，這些同心環可以壓平收攏，也可以再次展開拉伸，一體成形列印，無需組裝。只需一次 POST 請求即可將圖像一路處理成最終模型。該介面沒有 prototype（原型）/build（構建）兩階段的區分，也沒有可調整的 geometry 參數。每個任務花費 6 積分，回傳一個可列印的 STL 檔案，若 Meshy 能夠渲染預覽，還會額外提供一個用於預覽的 GLB 檔案。

Sep 3

  • Creative Lab Lamp API 的 prototype 階段現在會回傳一個 3D 模型。POST /prototype 會將概念圖轉換為中空的燈罩 GLB，prototype 任務物件在 image_urls 之外新增了 model_urls.glb 和 thumbnail_url。build 階段僅在該模型上執行燈具處理器，現在會產生一個帶底板（用於安裝光源裝置）的開底燈罩。Pricing 也隨之調整：prototype 為 30 積分，build 為 6 積分（此前為 6 和 30）。prototype 的 text 參數已被移除，image_url 變為必填項目。

Sep 2

  • Animation API 現在接受 action_ids，因此你可以在一次請求中為已綁定骨骼的角色套用最多 10 個預設動作，並取得一個包含每個動作對應一個動畫片段的單一檔案，可直接在遊戲引擎中由狀態機驅動。片段會按照你列出的順序排列，並帶有動畫所屬動畫庫的名稱。每個動作消耗 3 積分，post_process 套用於合併後的檔案。可用的 id 請參見 動畫庫參考，費用請參見 pricing 表。

Sep 1

  • 在 Multi-Image to 3D API 中新增了 ultra_mode 參數：可在 ai_model 為 meshy-7（或 latest）時啟用 Ultra 生成模式，以獲得更高保真度、表面細節更精細的 幾何體，需額外花費 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 任務使用情況（endpoint、狀態、時間戳記、執行每個任務的 API 金鑰，以及 consumed_credits），並支援標準分頁以及按時間區間、endpoint 和狀態進行篩選，便於成本追蹤和財務系統使用。

Aug 26

  • Animation API 現已支援 motion_task_id，這樣你就可以將透過 Text to Motion API 生成的動作片段套用到你的 rigged biped 角色上，作為預設 action_id 的替代方案。每個任務仍為 3 積分。

Aug 24

  • 為 Text to Image 和 Image to Image 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 prototype endpoint 新增了 remove_background 參數：Figure、Vinyl Figure、Brick Figure、Keycap、Keychain、Fridge Magnet以及Lamp。設定 remove_background: true 即可獲得去除背景、帶透明通道的 RGBA PNG 格式的 prototype 圖片。

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

  • 在 文字生成 3D API 中新增了 ai_model: "meshy-7"：這是我們最新的 3D 生成模型，相比 Meshy 6 擁有更高保真度的幾何體。它還為 preview 任務引入了 ultra_mode 參數，只需額外花費 5 積分，即可啟用 Ultra 生成，獲得更精細的表面細節。若要使用 Meshy 7 進行紋理 / 貼圖處理，請在 refine 任務中傳入 ai_model: "meshy-7"，或完全省略 ai_model 參數。
  • 在 文字生成 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 積分；詳情請參閱 價格。現有的 model_type: "lowpoly" 現已 已棄用，但基於向後相容考量仍會繼續提供服務。

Aug 12

  • 為 Image to 3D API 新增了 ai_model: "meshy-7"：我們最新的 3D 生成模型，相較於 Meshy 6 具有更高保真度的 geometry。它還引入了 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）。修復後的資源將以其輸入格式返回。

July 2026

Jul 27

  • 全新 Creative Lab 方塊小人 API：將一張照片轉換為積木風格的可收藏 3D 小人偶。它採用與 Q 版手辦 API 相同的兩階段工作流程。prototype（6 積分）生成風格化的概念圖像，build（30 積分）將其轉換為帶貼圖的 3D 模型，並輸出 GLB 和 OBJ + MTL 檔案。完整費用明細請參見 價格。

Jul 22

  • 全新 Creative Lab 鍵帽 API：將一張照片變成全彩訂製機械鍵盤鍵帽。它採用兩階段工作流程。prototype（12 積分）生成成品鍵帽設計效果圖，然後 build（50 積分）將你選定的設計（透過 candidate_id）轉換為帶貼圖的 3D 鍵帽模型，輸出 GLB 和 OBJ 捆綁檔案，並按真實世界毫米比例匯出。目前支援標準 Cherry MX 1u 底座（cherry-mx-1x1-r1），未來計畫支援更多標準尺寸。完整費用明細請參見 Pricing。

Jul 21

  • 我們現在透過 Image to 3D、Multi-Image to 3D、Text to 3D Refine 和 Retexture 端點上新增的 texture_resolution 參數（2k / 4k / 8k）支援 8K 底色貼圖。在 8k 下，PBR 貼圖以 4K 解析度生成，且不會生成發光貼圖。8K 貼圖生成消耗 15 積分（2k/4k 仍為 10 積分）。詳見 Pricing。
  • hd_texture 布林值已棄用，由 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（目前的低多邊形模型）和 meshy-t2（一個全新模型，具有更乾淨的 topology、原生分離的部件、三角面輸出，並可透過 target_polycount 設定面數）。在 smart-topology 下，meshy-t2 為預設模型。現有的 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 Unwrap API：為現有的 3D 模型生成高品質的 UV 展開（這是進行貼圖之前的必要步驟，或是當您需要為下游工具生成乾淨、無重疊的 UV 展開時使用）。此介面接受 input_task_id（已完成的 影象生成 3D、文字生成 3D 或 重構網格 任務）或 model_url（僅支援 .glb），並回傳一個帶有全新 UV 座標的「UV 白模」。每次呼叫消耗 5 積分。支援最多 40,000 個面的網格（若面數更多，請先執行 Remesh）；四邊形和多邊形網格會在生成 UV 時被三角化處理。

Jun 12

  • 將 Keychain、Fridge Magnet 和 Figure 的 Creative Lab API Build 定價更新為每次呼叫 30 積分（此前為 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 積分。

2026年5月

5月26日

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

5月22日

  • Remesh API 中的 convert 和 resize 功能現已作為獨立的 Convert API 和 Resize API 端點提供。Remesh 上已 deprecated 的參數將繼續保留以維持向後相容。

May 13

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

May 12

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

5 月 11 日

5 月 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 endpoint 的任務回應中新增了 consumed_credits 欄位。該欄位顯示每個任務所消耗的積分數量。處於 PENDING、IN_PROGRESS 和 SUCCEEDED 狀態的任務都會包含此欄位。對於 FAILED 狀態的任務，該欄位回傳 0（失敗時積分會自動退還）。各 endpoint 的積分消耗詳情請參閱 價格。

Apr 24

  • 為 多色列印 endpoint 新增了 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 參數。可以直接引用已完成的 Text to Image 或 影像生成影像任務的輸出，而無需提供 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 參數。該參數會從基礎顏色貼圖中去除高光和陰影，從而在自訂光照下獲得更乾淨的效果。僅支援 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 端點新增了詳細的 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 參數，用於產生針對更乾淨多邊形最佳化的 low-poly 網格。

2025 年 12 月

Dec 31

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

Dec 22

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

Dec 04

November 2025

Nov 24

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

Nov 06

  • Text to 3D Refine API 現已支援 ai_model = latest，該值會解析為 Meshy 6 Preview。
  • Image to 3D API 現在當 ai_model = latest 且 should_texture = true 時，預設使用 Meshy-6-preview 進行貼圖處理。
  • Multi-Image to 3D API 現已支援 ai_model = latest，預設使用 Meshy-6-preview 進行貼圖處理，而網格生成仍為 Meshy-5。
  • Retexture API 為 ai_model 新增了 latest 選項（Meshy-6-preview），並在省略該參數時預設使用此選項。

Nov 04

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

October 2025

Oct 28

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

Oct 20

  • 為 Remesh API 新增了可選的布林參數 convert_format_only，用於支援僅轉換輸入模型檔案的格式。
  • 在 The Rigging Task Object 的回應中新增了 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 格式。

2025 年 8 月

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

Jun 17

6月10日

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

2025年5月

5月20日

May 15

April 2025

Apr 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

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

Mar 14

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

Mar 06

  • 更新了 API 生成任務的價格：
    • Text to 3D (Preview)：每次呼叫由 2 積分提升至 5 積分
    • Text to 3D (Refine)：每次呼叫由 5 積分提升至 10 積分
    • Image to 3D：現為不含 texture 5 積分，含 texture 15 積分
    • Text to Texture：每次呼叫由 5 積分提升至 10 積分
    • Text to Voxel：仍為每次呼叫 5 積分

2025年2月

Feb 18

  • 新增了測試模式金鑰，讓開發者無需消耗積分即可測試 API 整合。使用此金鑰的所有有效請求都將回傳相同的範例任務結果。

Feb 13

  • 重大變更：

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

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

Feb 6

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

2025 年 1 月

Jan 23

1月14日

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

1月07日

2024 年 12 月

12月19日

  • 新增了 重構網格 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 路徑仍受支援，但我們建議切換到新路徑。

November 2024

Nov 14