Meshy V7 Text to 3D

整合

模型 id meshy/v7/text-to-3d

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/v7/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/meshy/v7/text-to-3d?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v7/text-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/zh-TW/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "meshy/v7/text-to-3d",
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }
}

透過 Doitong API 呼叫 Meshy V7 Text to 3D 模型（meshy/v7/text-to-3d）。代理程式文件：https://doitong.com/zh-TW/developers/models/meshy/v7/text-to-3d.md

POST https://api.doitong.ru/v1/run/meshy/v7/text-to-3d?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}

如果回應狀態為 "queued" 或 "running"，請輪詢 GET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20，直到狀態變為 "succeeded"；檔案位於 outputs[].url。使用相同主體傳送 POST https://api.doitong.ru/v1/quote/meshy/v7/text-to-3d，可在執行前取得確切價格。

像範例一樣的檔案: $1.20 1,200 API 點數 · ≈ ₽129.10 您的檔案會在執行前計量在此頁面執行

取得 API 金鑰

Meshy 文字轉 3D #stylized#transform

Meshy 7 文字轉 3D：預覽或完整模式、2k 幾何，以及 PBR、綁定骨架和動畫選項

OpenAPI Markdown

Meshy · 3D

您的第一個結果會顯示在這裡

在下方建立請求，並使用您的 API 金鑰執行。輸出會複製到我們的儲存空間，可永久保留或免費保留 7 天。

建立請求

控制項是根據模型結構描述生成的。變更設定時，程式碼和價格會同步更新。

prompt •必填 88 / 600

要表示為 3D 模型的物件描述，限制為 600 個字元。

mode 預設 full

生成模式：'preview' 輸出沒有紋理的幾何體，而 'full' 會結合 preview 和 refine 輸出有紋理的模型。

geometry_resolution

網格幾何體解析度；支援的 Meshy-7 選項為 standard 和 2k。

進階 texture_prompt · texture_image_url · model_type · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_safety_checker · ultra_mode

texture_prompt 0 / 600

在 'full' 模式中使用額外文字提示詞引導紋理；其他模式不使用此項。

texture_image_url

拖放檔案，或

用於紋理生成的 2D 參考圖像，僅套用於 'full' 模式。

model_type 預設 standard

3D 網格模式：選擇 'lowpoly' 以取得針對更乾淨多邊形最佳化的低多邊形結果；在此模式中 Meshy 會忽略 topology、target_polycount 和 should_remesh。若要取得傳統的高細節結果，請選擇 'standard'；或選擇 'smart-topology'，在幾何體（preview）步驟使用 Meshy-T2，並從一開始分別生成乾淨部件。

topology 預設 triangle

模型拓撲選項：Triangle 提供幾何細節，Quad 提供表面平滑度。

symmetry_mode 預設 auto

生成模型時套用的對稱設定。

pose_mode 預設

將字串留空以不指定生成模型的姿勢，或使用 'a-pose' 要求 A-pose，使用 't-pose' 要求 T-pose。

target_polycount 預設 30000

多邊形數量目標；當 model_type 為 'smart-topology' 時上限為 15,000。在該模式中省略目標值會選取 Meshy 較低的預設值 4,000。

rigging_height_meters 預設 1.7

當 enable_rigging 為 true 時，提供以公尺為單位的預估角色高度；否則此值不會產生作用。

animation_action_id 預設 92

Meshy 程式庫動畫預設值 ID，可用動作列於 https://docs.meshy.ai/en/api/animation-library。僅在 enable_animation 為 true 時驗證並使用：超出 [0, 696] 的值會以 422 拒絕，且 "Idle" 對應 `0`。

seed

將此種子與未變更的提示詞一起重複使用，通常可重現先前的結果。

POST /run/meshy/v7/text-to-3d?wait=20 報價 → $1.20

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/v7/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/meshy/v7/text-to-3d?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v7/text-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "meshy/v7/text-to-3d",
      "input": {
        "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
      },
      "wait_seconds": 20
    }
  }
}

執行此請求

API 金鑰

您的金鑰會保留在此瀏覽器中：只會傳送至 Doitong API，且只有在勾選「記住」時才會儲存至 localStorage。在此瀏覽器中記住取得 API 金鑰

關於 Meshy V7 Text to 3D

從最長 600 個字元的 `prompt` 產生 3D 模型，並可選用 `enable_prompt_expansion`。`mode` 回傳無貼圖幾何或有貼圖模型。透過 `model_type` 選擇 standard、lowpoly 或 smart-topology，將 `target_polycount` 設為 100 至 300000，並選擇 standard 或 2k 的 `geometry_resolution`。人形角色可加入綁定骨架和動畫預設。

參數

名稱類型預設值允許值說明

prompt必填

類型string

≤ 600 個字元

要表示為 3D 模型的物件描述，限制為 600 個字元。

mode選填

類型enum

預設值full

previewfull

生成模式：'preview' 輸出沒有紋理的幾何體，而 'full' 會結合 preview 和 refine 輸出有紋理的模型。

seed選填

類型integer | null

將此種子與未變更的提示詞一起重複使用，通常可重現先前的結果。

model_type選填

類型enum

預設值standard

standardlowpolysmart-topology

topology選填

類型enum

預設值triangle

quadtriangle

模型拓撲選項：Triangle 提供幾何細節，Quad 提供表面平滑度。

target_polycount選填

類型integer

預設值30000

100 – 300,000

多邊形數量目標；當 model_type 為 'smart-topology' 時上限為 15,000。在該模式中省略目標值會選取 Meshy 較低的預設值 4,000。

should_remesh選填

類型boolean

預設值true

將此值設為 false 可略過重新網格化並取得原始三角網格；否則啟用重新網格化階段。

symmetry_mode選填

類型enum

預設值auto

offautoon

生成模型時套用的對稱設定。

enable_pbr選填

類型boolean

預設值false

控制是否在基礎色旁生成金屬、粗糙度和法線 PBR 貼圖。

is_a_t_pose選填

類型boolean

預設值false

由 true 啟用的 T-pose 生成開關；已棄用，請改用 pose_mode。

pose_mode選填

類型enum

預設值

a-poset-pose

將字串留空以不指定生成模型的姿勢，或使用 'a-pose' 要求 A-pose，使用 't-pose' 要求 T-pose。

enable_prompt_expansion選填

類型boolean

預設值false

允許大型語言模型以詳細資訊豐富提示詞。啟用此擴展不會改變提示詞的含義。

texture_prompt選填

類型string | null

≤ 600 個字元

在 'full' 模式中使用額外文字提示詞引導紋理；其他模式不使用此項。

texture_image_url選填

類型url · image

用於紋理生成的 2D 參考圖像，僅套用於 'full' 模式。

enable_rigging選填

類型boolean

預設值false

自動人形骨架套用，最適合四肢清楚可辨的人形模型。啟用後會為生成模型套用骨架，並提供走路和跑步的基本動畫。

rigging_height_meters選填

類型number

預設值1.7

> 0

當 enable_rigging 為 true 時，提供以公尺為單位的預估角色高度；否則此值不會產生作用。

enable_animation選填

類型boolean

預設值false

是否為已套用骨架的模型加入預設動畫；需要 enable_rigging 為 true。

animation_action_id選填

類型integer

預設值92

enable_safety_checker選填

類型boolean

預設值true

前處理安全檢查開關：true 會將輸入安全檢查設為處理的必要條件。

geometry_resolution選填

類型enum

standard2k

網格幾何體解析度；支援的 Meshy-7 選項為 standard 和 2k。

ultra_mode選填

類型boolean

預設值false

已棄用的選項，由 geometry_resolution 取代；若兩者皆提供，geometry_resolution 優先。請改用 geometry_resolution='2k'。

必填

檔案參數接受公開的 https:// URL、最大 10 MB 的 data: URI，或上傳檔案的 file_url。檔案

輸出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7/text-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1200,
    "usd": "1.20",
    "charged": 1200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "animation_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "animation_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "thumbnail": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "obj": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "usdz": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "blend": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "stl": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "texture_urls": [
      {
        "base_color": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "metallic": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "normal": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "roughness": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        }
      }
    ],
    "seed": 42,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "rigged_character_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "rigged_character_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "basic_animations": {
      "walking_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "rig_task_id": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}

您的檔案，由您選擇每個 outputs[].url 都是儲存空間中的副本：可永久保留（按 GB-月計費），或免費保留 7 天；可透過帳戶設定或 ?storage= 設定。

所有模型使用相同結構圖片、影片和音訊皆包含 type、url、content_type、width、height 和 duration。output 是模型自己的結果物件。

輸出欄位

animation_glb: object {url, content_type, file_name, file_size} | null包含 GLB 3D 模型的動畫結果；除非 enable_animation 為 true，否則回應會省略此結果。
animation_fbx: object {url, content_type, file_name, file_size} | null包含 FBX 3D 模型的動畫結果；除非 enable_animation 為 true，否則回應會省略此結果。
model_glb: object {url, content_type, file_name, file_size}包含生成 3D 物件的 GLB 檔案。
thumbnail: object {url, content_type, file_name, file_size} | null顯示生成模型預覽的縮圖。
model_urls: object {glb, fbx, obj, usdz, blend, stl}各種格式的 3D 模型連結。
texture_urls: array of object {base_color, metallic, normal, roughness}以物件陣列表示的紋理檔案。
seed: integer | null生成期間使用的種子值。
prompt: string提供給生成使用的文字提示詞。
actual_prompt: string | null啟用提示詞擴充時實際套用於生成的提示詞。
rigged_character_glb: object {url, content_type, file_name, file_size} | null以 GLB 角色檔案提供的骨架套用結果；除非 enable_rigging 為 true，否則不會出現在回應中。
rigged_character_fbx: object {url, content_type, file_name, file_size} | null以 FBX 角色檔案提供的骨架套用結果；除非 enable_rigging 為 true，否則不會出現在回應中。
basic_animations: object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | null基本走路和跑步動畫，僅在 enable_rigging 為 true 時包含。
rig_task_id: string | null骨架套用工作的識別碼；僅在 enable_rigging 為 true 時包含。

更多模型：文字轉 3D

給 AI 代理程式：此頁面的 Markdown 位於 https://doitong.com/zh-TW/developers/models/meshy/v7/text-to-3d.md. 所有模型與指南： https://doitong.com/developers/llms.txt

您的第一個結果會顯示在這裡

建立請求

執行此請求

關於 Meshy V7 Text to 3D

參數

輸出

其他 Meshy v7 變體

Meshy V7 Image to 3D 變體：4

Meshy V7 Multi Image to 3D 變體：4

Meshy 7 Retexture 變體：4

更多模型：文字轉 3D

Meshy 6 Preview · Text to 3D 變體：2

Meshy 6 · Text to 3D 變體：2

Meshy 7.1 Text to 3D 變體：3

Hunyuan 3d 變體：6