lowpoly 將於 2026年10月30日 下線。 請在這些日期前切換模型，以免請求出錯。

更新日誌

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

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

2026 年 10 月

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

  • 在 重新貼圖、重構網格、骨骼綁定、格式轉換、尺寸調整、UV 展開、多色列印、可列印性分析 和 可列印性修復 中，當 model_url 為 http 或 https URL 時，其接受的檔案大小上限現已提升至 400 MB（此前為 100 MB）。data: URI 仍保持 100 MB 上限。超過 100 MB 的 GLB、glTF、FBX 或 OBJ 檔案，其面數（按三角形計算）最多為 10,000,000（多色列印為 8,000,000）；超過該數量的檔案將回傳 400。超過 100 MB 時，FBX 檔案必須為二進位 FBX 7.1 或更高版本，且 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 檔案不受此變更影響。

Oct 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，它使用相同的參數且 credit 消耗相同。使用 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,...）。現有整合不受影響，價格也保持不變。
  • 取得餘額 現在還會回傳 monthly_credits、permanent_credits 和 monthly_resets_at，方便您瞭解下次重置時有多少餘額將會過期。balance 本身保持不變。

Oct 6

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

2026年9月

Sep 29

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

9 月 28 日

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

9 月 18 日

  • 為 Image to 3D、 Multi-Image to 3D 和 Text to 3D 新增了 ai_model 值 meshy-7.1：參數和 credit 消耗與 meshy-7 相同，幾何細節更高。latest 現在解析為 meshy-7.1；meshy-7 已 deprecated，但仍可照常使用。
  • 在相同的 API 中新增了 geometry_resolution（standard / 2k / 4k），用於取代現已 deprecated 的 ultra_mode（ultra_mode: true 仍然可用，等同於 "2k"）。4k 需要 Meshy 7.1（meshy-7.1 或 latest），在 Multi-Image to 3D 上不可用，且與 2k 一樣，額外花費 5 個積分。

Sep 16

  • Auto Split API 現在接受帶貼圖的 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 已停用；仍發送該金鑰的請求現在會傳回 401 Unauthorized。如果你曾將其複製到程式碼或 CI 中，請從 API Keys 頁面替換為你自己的金鑰。該金鑰無論輸入是什麼，始終傳回相同的範例模型，因此它從未真正展示過請求實際會產生什麼內容。如果想在建構請求之前先了解 API 的回傳結果，可以使用開發者平台中的 Playground，它會在你的瀏覽器中執行一個真實任務。在沒有 API 存取權限的方案上，它會在不使用 API key 的情況下執行 Image to 3D，並像其他任務一樣消耗你帳戶的 credits。

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 下的所有任務系列。詳見錯誤。
  • 為文字生成 3D、影象生成 3D、多圖生成 3D和重新貼圖 API 新增了文件化的 ai_model 數值 meshy-6-lite。它是 meshy-5 的繼任版本：參數相同，積分消耗相同（網格為 5，帶貼圖為 15，重新貼圖為 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 介面至 動畫庫：取得 Animation API 支援的所有預設動作 —— action_id、名稱、分類，以及動圖預覽 —— 並支援搜尋和分類篩選，讓你可以建構自己的動作選擇器，而不必查閱參考表格。免費，不消耗積分。
  • 新增 Creative Lab Collapsible Fidget API：將照片轉換為可直接列印、無需組裝的可摺疊減壓玩具 —— 主體的輪廓會變成層層嵌套的同心環，可壓扁收起，也可再次拉伸展開，一體成型列印。單次 POST 請求即可從圖片直接生成最終模型 —— 沒有 prototype（原型）/build（成品）兩階段，也沒有可調整的 geometry 參數。每個任務消耗 6 積分，並回傳可列印的 STL 檔案以及用於預覽的 GLB 檔案。

Sep 3

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

Sep 2

  • 動畫 API 現已支援 action_ids——可在一次請求中為已綁定骨骼（rig）的角色套用最多 10 個預設動作，並獲得一個包含每個動作對應動畫片段的單一檔案，可直接用於遊戲引擎中的狀態機驅動。片段會按照你列出的順序排列，並帶有該動畫所屬動畫庫的名稱。每個動作消耗 3 credits，且 post_process 將作用於合併後的檔案。可用的 id 請參閱動畫庫參考，費用請參閱 價格表格。

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 文件中移除了 meshy-t1 這一 ai_model 取值。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

  • Animation API 現已支援 motion_task_id——將使用 Text to Motion API 產生的動作片段套用到你已綁定骨骼（rigged）的雙足角色上，作為預設 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 原型 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 參數，啟用 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 具有更高保真度的 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）。修復後將以輸入格式回傳修復後的 asset。

2026 年 7 月

Jul 27

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

Jul 22

  • 新增 Creative Lab — Keycap 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 endpoint 上新增的 texture_resolution 參數（2k / 4k / 8k）支援 8K 基礎色貼圖。在 8k 下，PBR 貼圖以 4K 產生，且不會產生 emission 貼圖。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 設定面數的新模型。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 同時使用。

2026 年 6 月

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

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

Jun 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 積分。

May 2026

May 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 的參數仍將繼續可用，以保持向後相容性。

5 月 13 日

  • 在 Image to 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

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

2026年4月

4月27日

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

4月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 參數。可直接引用已完成的文字生成影像或影像生成影像任務的輸出結果，而無需提供 image_url / image_urls。當兩者同時提供時，input_task_id 具有更高的優先順序。

Apr 20

Apr 14

Apr 12

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

2026年3月

Apr 2

  • 在所有端點（影象生成 3D、文字生成 3D、重構網格、重新貼圖）的 target_formats 參數中新增 3mf 格式支援。注意：3MF 為可選項，必須明確請求才會啟用。
  • 全新 多色列印 API：將 3D 模型格式轉換為多色 3MF 格式以用於 3D 列印。支援 1-16 色調色板，並可設定精度。每個任務消耗 10 積分。

Mar 20

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

Mar 17

February 2026

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 參數，用於生成經過優化、具有更簡潔多邊形的 低多邊形 網格。

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

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

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

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

Dec 04

2025年11月

Nov 24

  • Image to 3D 和 Multi-Image to 3D API 新增了可選的 save_pre_remeshed_model 參數，並在請求 pre-remesh 備份時提供 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 現在會為上傳的模型保留 texture。
  • Retexture API 在啟用 enable_original_uv 選項時，現在會為上傳的模型保留 texture。

2025 年 10 月

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。

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

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

  • 在 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：現為不含紋理時 5 積分，含紋理時 15 積分
    • Text to Texture：每次呼叫由 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 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 路徑仍然受到支援，但我們建議切換到新路徑。

November 2024

Nov 14