更新日誌
查看 Meshy API 和外掛的所有最新功能與更新。
更喜歡即時動態嗎?最新項目也會顯示在開發者平台概覽頁面上。
2026 年 9 月
Sep 18
- 為 Image to 3D、
Multi-Image to 3D 和
Text to 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 現在接受帶紋理的
input_task_id。此前它會以400拒絕該請求,這意味著必須先以should_texture: false再產生一次同一個 mesh 才能對其進行拆分。請注意拆分會回傳什麼:它會切割 geometry 並為每個部件重建表面,因此輸入的 texture 不會被保留,結果是一個未上色的模型,每個部件呈現單一純色——這一點在每次拆分中都一直如此,並未發生變化。 meshy-5已停用。它不再是 Text to 3D、Image to 3D、Multi-Image to 3D 或 Retexture 可用的ai_model值之一。如果你的整合傳送了ai_model: "meshy-5",請切換到meshy-6-lite——它接受相同的參數,價格也相同。
9 月 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)現在在文字生成影像與影像生成影像 API 中,除支援1:1、16:9、9:16、3:2和2:3外,還支援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的繼任版本:參數相同,credit 消耗相同(網格為 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、名稱、分類以及動畫 GIF 預覽──並支援搜尋和分類篩選,讓你可以自行建立動作選擇器,而無需查閱參考表格。免費提供,不消耗積分。 - 新增 Creative Lab 可折疊指尖玩具 API:將一張照片轉換為可直接列印使用的可折疊指尖玩具,其中主體的輪廓會變成嵌套的同心圓環,可以壓平折疊,也可以再次展開,一體成型列印,無需組裝。單次
POST請求即可將圖像直接生成最終模型──沒有 prototype(原型)/build(成品)兩階段流程,也沒有可調整的 geometry 參數。每個任務消耗 6 積分,回傳可列印的 STL 以及用於預覽的 GLB。
Sep 3
- Creative Lab 燈具 API 的 prototype(原型)階段現在會回傳一個 3D 模型:
POST /prototype會將概念圖轉換為一個中空的燈罩 GLB,並且 prototype 任務物件在image_urls之外新增了model_urls.glb和thumbnail_url。build(建構)階段只會對該模型執行燈具處理器,現在會產生一個底部開口、帶有光源固定裝置底板的燈罩。Pricing 也隨之調整:prototype 為 30 credits,build 為 6 credits(此前分別為 6 和 30)。prototype 的text參數已被移除 —— 現在image_url為必填項目。
Sep 2
- Animation 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 生成模式,可獲得更高保真度、更精細表面細節的 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 任務使用情況——包括 endpoint、狀態、時間戳記、執行每個任務所用的 API 金鑰,以及
consumed_credits——並支援標準分頁以及依時間範圍、endpoint 和狀態篩選,便於成本追蹤和財務系統使用。
Aug 26
- Animation 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:可根據自然語言描述生成角色動作片段,無需角色模型。選擇
primemode(10 積分,輸出 FBX)以獲得最高品質,或選擇swiftmode(3 積分,輸出 BVH)以實現快速、經濟的生成,片段時長為 2-10 秒。
Aug 20
- 為 多色列印 API 新增
style參數:選擇realistic(預設)以獲得與 texture 一致的精確顏色,或選擇cartoon以獲得平面、統一的色塊區域和更小的 3MF 檔案。 - 為每個 Creative Lab 原型端點新增了
remove_background參數 —— Q 版手辦、Vinyl Figure、方塊小人、Keycap、鑰匙扣、冰箱貼 和 燈具。將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 積分;詳見 價格。現有的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
- 將 可列印性分析 和 可列印性修復 endpoint 的
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
- 我們現在透過 Image to 3D、Multi-Image to 3D、Text to 3D Refine 和 Retexture 端點上的新
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設定面數的新模型。meshy-t2是smart-topology下的預設模型。現有的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同時使用。
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 個面的網格(若面數更多,請先執行 重構網格);四邊形和 N 邊形網格會在 UV 生成過程中被三角化。
Jun 12
- 已將 Creative Lab API 的 Build pricing 更新為每次呼叫 30 credits,適用於 Keychain、Fridge Magnet 和 Figure(此前為 20 credits)。Lamp 保持不變,仍為 30 credits。Prototype pricing 保持不變,仍為每張圖片 6 credits。完整明細請參見 Pricing。
Jun 5
- 為 Image to 3D、Multi-Image to 3D、Text to 3D、Retexture、Remesh 和 Repair Printability API 新增了可選參數
alpha_thumbnail。當設定為true時,任務會額外算繪一個透明背景(RGBA)版本的預覽圖,並透過新的alpha_thumbnail_url回應欄位傳回。現有的thumbnail_url保持不變。預設值為false。
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 上已 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互斥。
May 11
- 已棄用 Text to 3D、Image to 3D 和 Multi-Image to 3D 介面上的
symmetry_mode參數。該參數不再影響輸出結果。
May 7
- 全新 可列印性分析 API:對已成功完成的 Meshy 任務——或任意 3D 模型 URL——進行 FDM 3D 列印就緒度分析。採用非同步建立+串流回傳模式:POST 請求會回傳 task_id,隨後 GET/SSE 串流會在任務變為 SUCCEEDED 後回傳 watertightness、體積、孔洞及非流形邊等指標。完全免費,不消耗積分。
- 全新 可列印性修復 API:對 3D 模型進行修復以符合 FDM 可列印性要求——修復非流形邊、退化面、孔洞及其他 topology 問題。支援傳入已有的 Meshy
input_task_id或model_url(.glb、.stl、.obj)。輸出格式與輸入保持一致。每個任務消耗 10 積分。
2026年4月
Apr 27
- 在所有 API endpoint 的任務回應中新增了
consumed_credits欄位。該欄位顯示每個任務所消耗的 credits 數量。對於處於PENDING、IN_PROGRESS和SUCCEEDED狀態的任務,會回傳該欄位。對於FAILED狀態的任務,則回傳0(失敗時會自動退還 credits)。各 endpoint 的 credit 費用請參見 價格。
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參數。可直接引用已完成的文字生成影像或影像生成影像任務的輸出結果,而無需提供image_url/image_urls。當兩者同時提供時,input_task_id具有更高的優先順序。
Apr 20
- 在 Image to 3D、Multi-Image to 3D、Text to 3D Refine 以及 Retexture 端點中新增了
hd_texture參數。啟用後,基礎顏色 texture 將以 4K(4096×4096)解析度生成,以獲得更高的細節表現。該參數僅支援meshy-6和latest,預設值為false。 - 當
enable_pbr為true時回傳的 PBR 組合現在會在texture_urls下為 Image to 3D、Multi-Image to 3D、Text to 3D Refine 以及 Retexture 的meshy-6和latest任務包含一張emission貼圖。無需對請求做任何變更。
Apr 14
- 在 影象生成 3D、多圖生成 3D、文字生成 3D 預覽 和 重構網格 端點中新增了
decimation_mode參數。用於設定自適應減面面數級別:1(超高)、2(高)、3(中)或4(低)。
Apr 12
- 重構了 API 文件:新增了具有相依欄位的參數分組、內嵌預設值、必填/已棄用徽章、可展開的子導覽,並將多圖、骨架綁定和動畫拆分為獨立頁面。
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
- 為 Image to 3D、Multi-Image to 3D、Text to 3D 和 Retexture 端點添加了可選的
target_formats參數。指定要生成的 3D 格式(例如["glb", "fbx"]),以縮短任務完成時間。
February 2026
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 texture 處理。
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)設計的,未來版本中將被移除。 - 棄用了 Text to 3D 和 Image to 3D API 中當
ai_model為meshy-4時的enable_pbr參數。該參數將在未來版本中被移除。 - 更新了 Text to 3D 和 Image to 3D API 中 Meshy-6 的
should_remesh參數預設值。若未指定,該參數在meshy-6下預設值現為false,在其他模型下預設值為true。
Jan 19
- Text to 3D (Preview) 和 Image to 3D API 中
ai_model的latest選項現在會解析為 Meshy 6。
Jan 12
- 在 Image to 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
- 文字生成 3D API 回應中的
video_url欄位現已 已棄用,並將在未來版本中移除。
Dec 04
- 在 Text to 3D Preview、影象生成 3D 和 多圖生成 3D API 中新增了
pose_mode參數。該參數接受a-pose、t-pose或空字串(預設值)。is_a_t_pose參數現已 已棄用,請改用pose_mode。
November 2025
Nov 24
- 影象生成 3D 和 多圖生成 3D API 新增了可選參數
save_pre_remeshed_model,當請求預 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 現在會為上傳的模型保留材質。
- 當啟用
enable_original_uv選項時,Retexture API 現在會為上傳的模型保留材質。
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-voxelAPI
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
- 更新了 Text to 3D 和 Image to 3D 的 API 價格,以反映 Meshy 6 與其他模型之間的不同費用。
Sep 16
- 在 Image to 3D API 的
ai_model中新增了latest選項,用於使用 Meshy 6 Preview。
Sep 4
August 2025
Aug 18
- 在 Text to 3D Preview、Image to 3D 和 Multi-Image to 3D API 中新增了可選參數
is_a_t_pose,用於生成 A/T 姿勢的模型。
Aug 13
- Meshy 5 現已針對 Text to 3D 和 Image to 3D(
ai_model:meshy-5)穩定發布,帶來了更優的品質與一致性。
2025 年 7 月
Jul 31
- 透過
enable_pbr參數為最新的meshy-5模型在 Text to 3D、Image to 3D、Multi-Image to 3D 和 Retexture 端點中支援 PBR 貼圖。
2025 年 6 月
Jun 25
- 新增 Retexture API,允許使用者基於 Meshy 最新的基礎 AI 模型對 3D 模型進行重新貼圖。
Jun 19
- 為 Text to 3D、Image to 3D、Remesh、Rigging 和 Animation 新增了刪除 API。
- 為 Text to 3D Refine API 新增了
ai_model參數。
Jun 17
- 新增了 Webhooks 相關文件。
6月10日
- Remesh API 現在支援透過 Data URI 在
model_url參數中傳入 base64 編碼的 GLB 格式模型。
2025年5月
5月20日
- 為 Text to 3D Preview、Text to 3D Refine、Image to 3D 和 Multi-Image to 3D API 新增了可選
moderation參數。啟用後,系統會在生成前自動對輸入內容進行潛在有害內容的審查。
5 月 15 日
- 引入了自動綁定與動畫(Auto-rigging & Animation)API,使用戶能夠自動為 3D 模型添加綁定並生成動畫。了解更多關於 Rigging 的內容以及 Animation。
2025 年 4 月
4 月 29 日
- 引入了 Multi-Image to 3D API,允許使用
meshy-5AI 模型透過 1 到 4 張輸入圖片生成 3D 模型。 - 在 Text to 3D 和 Image to 3D API 中新增了
meshy-5AI 模型選項。latest標籤現在也會指向meshy-5。
Apr 17
- 為 Image to 3D 和 Text to 3D Refine API 新增了
texture_image_url參數,允許使用者使用圖片引導 texture 生成過程。
March 2025
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 生成任務的 Pricing:
- Text to 3D(Preview):由每次呼叫 2 credits 提高至 5 credits
- Text to 3D(Refine):由每次呼叫 5 credits 提高至 10 credits
- Image to 3D:現為不含 texture 5 credits,含 texture 15 credits
- Text to Texture:由每次呼叫 5 credits 提高至 10 credits
- Text to Voxel:維持每次呼叫 5 credits 不變
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 來引導 texture 生成過程。
January 2025
Jan 23
- 為 Text to 3D、Image to 3D、Remesh 和 Text to Texture API 新增了用於列出任務的端點。
Jan 14
- 棄用了由 Meshy-3 AI 模型驅動的 Legacy Text to 3D 和 Image to 3D API。
Jan 07
- 為 Text to 3D Preview 和 Image to 3D API 新增了
symmetry_mode參數,允許設定 symmetry 設定。
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
- 為 Image to 3D 和 Text to 3D Refine API 新增了
enable_pbr參數。 - 為 Image to 3D API 新增了
should_texture參數。 - 當使用
meshy-4AI 模型時,棄用了 Text to 3D Preview API 的art_style參數中的pbr選項。 - 棄用了 Text to 3D Preview API 的
art_style參數中的low-poly選項。
Dec 5
- 新增了 Get Balance API,允許使用者查詢自己的 credit 餘額。
- 為 Image to 3D 和 Text to 3D Preview API 新增了
should_remesh參數。
Dec 3
- 外部 API 現在使用
/openapi前綴。Legacy 路徑仍然受支援,但我們建議切換到新路徑。
November 2024
Nov 14
- Image to 3D API 現已支援 base64 編碼的圖片。