3D
Meshy 6 Preview · Image to 3D 變體：2
起價 $0.80
800 API 點數 · ≈ ₽85.85
Meshy 6 Preview · Text to 3D
整合
模型 id
meshy/v6-preview/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/v6-preview/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/v6-preview/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/v6-preview/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/v6-preview/text-to-3d",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
}透過 Doitong API 呼叫 Meshy 6 Preview · Text to 3D 模型（meshy/v6-preview/text-to-3d）。代理程式文件：https://doitong.com/zh-TW/developers/models/meshy/v6-preview/text-to-3d.md
POST https://api.doitong.ru/v1/run/meshy/v6-preview/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/v6-preview/text-to-3d，可在執行前取得確切價格。此請求: $0.80 800 API 點數 · ≈ ₽85.85 在此頁面執行
您的新 API 金鑰。 僅會在此時顯示，且已填入下方的程式碼與 API 金鑰欄位。請妥善保密：切勿將其放入在瀏覽器中執行的程式碼。
建立請求
控制項是根據模型結構描述生成的。變更設定時，程式碼和價格會同步更新。
POST
/run/meshy/v6-preview/text-to-3d?wait=20
報價 → $0.80
# 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/v6-preview/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/v6-preview/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/v6-preview/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/v6-preview/text-to-3d",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"wait_seconds": 20
}
}
}關於 Meshy 6 Preview · Text to 3D
從最長 600 個字元的提示建立 3D 模型。`mode` 設為 preview 時產生無貼圖幾何，設為 full 時產生有貼圖模型。選項包括 `enable_prompt_expansion`、網格類型、拓撲、`target_polycount`（100 至 300000）、PBR 貼圖、姿勢模式，以及搭配動畫預設的人形綁定骨架。
參數
名稱類型
預設值允許值
說明
prompt必填
類型string
≤ 600 個字元
要表示為 3D 模型的物件描述，限制為 600 個字元。
mode選填
類型enum
預設值full
previewfull
生成模式：'preview' 輸出沒有紋理的幾何體，而 'full' 會結合 preview 和 refine 輸出有紋理的模型。
seed選填
類型integer | null
將此種子與未變更的提示詞一起重複使用，通常可重現先前的結果。
model_type選填
類型enum
預設值standard
standardlowpolysmart-topology
3D 網格模式：選擇 'lowpoly' 以取得針對更乾淨多邊形最佳化的低多邊形結果；在此模式中 Meshy 會忽略 topology、target_polycount 和 should_remesh。若要取得傳統的高細節結果，請選擇 'standard'；或選擇 'smart-topology'，在幾何體（preview）步驟使用 Meshy-T2，並從一開始分別生成乾淨部件。
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
Meshy 程式庫動畫預設值 ID，可用動作列於 https://docs.meshy.ai/en/api/animation-library。僅在 enable_animation 為 true 時驗證並使用：超出 [0, 696] 的值會以 422 拒絕，且 "Idle" 對應 `0`。
enable_safety_checker選填
類型boolean
預設值true
前處理安全檢查開關：true 會將輸入安全檢查設為處理的必要條件。
必填
檔案參數接受公開的 https:// URL、最大 10 MB 的 data: URI，或上傳檔案的 file_url。 檔案
輸出
GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "meshy/v6-preview/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": 800,
"usd": "0.80",
"charged": 800,
"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 時包含。
其他 Meshy 6 Preview 變體
更多模型：文字轉 3D
給 AI 代理程式：此頁面的 Markdown 位於 https://doitong.com/zh-TW/developers/models/meshy/v6-preview/text-to-3d.md. 所有模型與指南： https://doitong.com/developers/llms.txt