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

AI 整合

Meshy 為 AI 代理與程式設計助手提供兩種接入管道：用於工具呼叫的 Meshy MCP server，以及用於文件擷取的 llms.txt / llms-full.txt。

如果你正在透過 Claude Code、Cursor、Windsurf、Codex 或任何其他相容 MCP 的工具接入 Meshy，請依照下方說明安裝 MCP server。如果你是透過不支援 MCP 的純聊天代理接入，請改為將其指向 https://docs.meshy.ai/llms.txt。

什麼是 MCP

Model Context Protocol (MCP) 是一種開放標準，允許 AI 助手呼叫外部工具並取得結構化上下文。Meshy MCP server 將 Meshy REST API 封裝為一組可供你的代理呼叫的工具——產生模型、檢查任務、下載結果——而無需手動撰寫 HTTP 程式碼。

此 MCP server 是開源的，已以 @meshy-ai/meshy-mcp-server 的形式發布於 npm 上。原始碼：github.com/meshy-dev/meshy-mcp-server。

你需要一個 Meshy API key。可以在開發者平台的 API Keys 頁面建立一個。MCP server 會從 MESHY_API_KEY 環境變數中讀取該金鑰。

快速安裝

# Detects installed AI clients and configures Meshy for each
npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY

更想要開箱即用的技能包？ 開源的 meshy-3d-agent 技能包為 Claude Code、Cursor 和 OpenClaw 提供了預先寫好的 Meshy 工作流程（產生 → 輪詢 → 下載）。它直接呼叫 Meshy REST API——無需 MCP server。

npx skills add meshy-dev/meshy-3d-agent

可用工具

MCP server 將 Meshy REST API 依功能分組，公開為工具。

3D 生成

  • meshy_text_to_3d：根據文字 prompt 建立未貼圖的預覽 mesh
  • meshy_image_to_3d：根據單張圖片建立 3D 模型
  • meshy_multi_image_to_3d：根據同一物體的多張圖片建立 3D 模型
  • meshy_text_to_3d_refine：為預覽 mesh 新增貼圖

後處理

  • meshy_remesh：變更現有模型的 topology 和/或面數
  • meshy_retexture：為現有模型套用新的貼圖
  • meshy_rig：為 3D 人形角色新增骨架
  • meshy_animate：為已綁定骨架的角色套用動畫
  • meshy_convert：將模型格式轉換為其他檔案格式
  • meshy_resize：將模型調整為真實世界尺寸
  • meshy_uv_unwrap：為模型產生新的 UV 佈局

Creative Lab

  • meshy_creative_lab：將一張照片轉變為完整的 Creative Lab 產品（執行 prototype 與建構任務）

影像生成

  • meshy_text_to_image：根據文字產生 2D 影像
  • meshy_image_to_image：根據參考影像產生 2D 影像

任務管理

  • meshy_get_task_status：檢查任務狀態與下載連結
  • meshy_list_tasks：列出最近的任務，可依類型/狀態篩選
  • meshy_cancel_task：刪除任務。PENDING 狀態的任務會被移除並退款；IN_PROGRESS 狀態的任務無法取消（API 會回傳 409）；已完成的任務會被刪除。
  • meshy_download_model：取得已完成的模型檔案並儲存到本機

工作區

  • meshy_list_models：列出你最近的文字生成 3D 模型（其他任務類型請使用 meshy_list_tasks）

3D 列印

  • meshy_send_to_slicer：偵測已安裝的切片軟體，並回傳在其中開啟模型的指令（在本機執行；不會呼叫 Meshy API）
  • meshy_analyze_printability：免費的自動化 FDM 可列印性檢查（水密性、體積、孔洞、非流形邊、退化面）
  • meshy_process_multicolor：將帶有貼圖的模型轉換為用於列印的多色 3MF 檔案
  • meshy_repair_printability：修復模型以用於 FDM 列印

帳戶

  • meshy_check_balance：查詢剩餘積分

工具名稱與行為可能會演變。權威清單位於 MCP server 原始碼中。

範例 Prompt

將以下內容放入支援 MCP 的聊天中作為起點。

Generate a 3D fox from the prompt "a cartoon fox sitting", preview it, then
texture it with PBR maps. Download the final GLB to ./outputs.

Take the image at https://example.com/sculpture.jpg and convert it into a
riggable 3D character. Use `should_remesh: true` and 50k target polycount.

What's my current Meshy credit balance?

List my last 10 successful text-to-3d tasks and download the top 3 as GLB
into ./downloads/.

llms.txt 和 llms-full.txt

如果你的代理不支援 MCP，或者你想直接將 Meshy 文件擷取到 prompt 中，可以將其指向我們提供的純文字介面：

  • llms.txt —— 簡明索引 + 整合說明（正確的非同步輪詢模式、驗證規則、速率限制、模型選擇、常見錯誤）。
  • llms-full.txt —— 將所有 API 頁面拼接成單一檔案，便於一次性抓取擷取。
  • 依頁面 Markdown：在任意 endpoint URL 後方加上 .md。例如：https://docs.meshy.ai/api/text-to-3d.md。

這三者都會在文件網站每次建置時重新產生，因此永遠不會與 HTML 文件產生偏差。

常見問題

Is the MCP server stateless?
Yes. Your MESHY_API_KEY is used per request and never persisted on the server side.
Does MCP cost the same as the REST API?
Yes — every MCP tool call maps to a single REST call and consumes credits at the exact same rate. See the Pricing page for the full matrix.
What are the rate limits?
The MCP server shares the same rate-limit plane as the REST API. See the Rate Limits page for per-tier limits.
What Meshy data can the MCP access?
Only what the MESHY_API_KEY can access via REST. Scopes and permissions are identical.
How do I report issues?
File an issue at the meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues