3D
Meshy 6 · Image to 3D Varian: 2
daripada $0.80
800 kredit API
Meshy 6 · Text to 3D
Integrasikan
ID model
meshy/v6/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.com/v1/run/meshy/v6/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.com/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"const API = "https://api.doitong.com/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/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.com/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/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/ms/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "meshy/v6/text-to-3d",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
}Panggil model Meshy 6 · Text to 3D (meshy/v6/text-to-3d) melalui Doitong API. Dokumentasi untuk ejen: https://doitong.com/ms/developers/models/meshy/v6/text-to-3d.md
POST https://api.doitong.com/v1/run/meshy/v6/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"
}
Jika status respons ialah "queued" atau "running", tinjau GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 sehingga statusnya menjadi "succeeded"; fail berada dalam outputs[].url. POST https://api.doitong.com/v1/quote/meshy/v6/text-to-3d dengan badan yang sama mengembalikan harga tepat sebelum dijalankan.Permintaan ini: $0.80 800 kredit API Jalankan pada halaman ini
Kunci API baharu anda. Ia hanya dipaparkan sekarang dan sudah dimasukkan dalam kod serta medan kunci API di bawah. Simpan secara rahsia: jangan sekali-kali letakkannya dalam kod yang berjalan dalam pelayar.
Meshy · 3D
Hasil pertama anda akan muncul di sini
Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.
Bina permintaan
Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.
POST
/run/meshy/v6/text-to-3d?wait=20
sebut harga → $0.80
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/meshy/v6/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.com/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"const API = "https://api.doitong.com/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/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.com/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/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/text-to-3d",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"wait_seconds": 20
}
}
}Jalankan permintaan ini
Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API
Tentang Meshy 6 · Text to 3D
Membina model 3D daripada `prompt` teks sehingga 600 aksara. `mode` memilih geometri tanpa tekstur (`preview`) atau hasil bertekstur (`full`). `model_type` boleh berupa standard, lowpoly atau smart-topology, dan `target_polycount` berjulat dari 100 hingga 300000, dengan topologi pintar dihadkan kepada 15000. Ia juga boleh menambah peta PBR, pose, rig humanoid dan praset animasi.
Parameter
NamaJenis
LalaiDibenarkan
Penerangan
promptdiperlukan
Jenisstring
≤ 600 aksara
Huraian objek untuk diwakili sebagai model 3D, dihadkan kepada 600 aksara.
modepilihan
Jenisenum
Lalaifull
previewfull
Mod penjanaan: 'preview' menghasilkan geometri tanpa tekstur, manakala 'full' menghasilkan model bertekstur dengan menggabungkan preview dan refine.
seedpilihan
Jenisinteger | null
Guna semula benih ini bersama prompt yang tidak berubah untuk biasanya menghasilkan semula hasil terdahulu.
model_typepilihan
Jenisenum
Lalaistandard
standardlowpolysmart-topology
Mod jerat 3D: pilih 'lowpoly' untuk hasil poligon rendah yang dioptimumkan bagi poligon lebih kemas; dalam mod ini Meshy mengabaikan topology, target_polycount dan should_remesh. Untuk hasil perincian tinggi konvensional, pilih 'standard', atau pilih 'smart-topology' untuk menggunakan Meshy-T2 semasa langkah geometri (preview) dan mendapatkan bahagian kemas yang dijana secara berasingan sejak awal.
topologypilihan
Jenisenum
Lalaitriangle
quadtriangle
Pilihan topologi model antara Triangle untuk perincian geometri dan Quad untuk kelicinan permukaan.
target_polycountpilihan
Jenisinteger
Lalai30000
100 – 300,000
Sasaran bilangan poligon, dihadkan kepada 15,000 apabila model_type ialah 'smart-topology'. Jika sasaran tidak ditentukan dalam mod itu, lalai Meshy yang lebih rendah, iaitu 4,000, digunakan.
should_remeshpilihan
Jenisboolean
Lalaitrue
Langkau penjeratan semula dan terima jerat segi tiga mentah dengan menetapkan nilai ini kepada false; jika tidak, dayakan fasa penjeratan semula.
symmetry_modepilihan
Jenisenum
Lalaiauto
offautoon
Tetapan simetri yang digunakan semasa menjana model.
enable_pbrpilihan
Jenisboolean
Lalaifalse
Mengawal penjanaan peta PBR metalik, kekasaran dan normal bersama warna asas.
is_a_t_posepilihan
Jenisboolean
Lalaifalse
Suis penjanaan pose-T yang diaktifkan oleh true; tidak digunakan lagi dan digantikan dengan pose_mode.
pose_modepilihan
Jenisenum
Lalai
a-poset-pose
Biarkan rentetan kosong untuk tidak menentukan pose model yang dijana, atau minta pose-A dengan 'a-pose' atau pose-T dengan 't-pose'.
enable_prompt_expansionpilihan
Jenisboolean
Lalaifalse
Benarkan model bahasa besar memperkaya prompt dengan butiran. Mendayakan pengembangan ini mengekalkan maksud prompt.
texture_promptpilihan
Jenisstring | null
≤ 600 aksara
Bimbing tekstur dengan prompt teks tambahan dalam mod 'full'; mod lain tidak menggunakannya.
texture_image_urlpilihan
Jenisurl · image
Imej rujukan 2D untuk penjanaan tekstur, digunakan hanya dalam mod 'full'.
enable_riggingpilihan
Jenisboolean
Lalaifalse
Pemasangan rangka humanoid automatik, paling berkesan untuk model humanoid yang anggota badannya jelas dapat dibezakan. Mendayakannya memasang rangka pada model yang dijana dan membekalkan animasi asas berjalan dan berlari.
rigging_height_meterspilihan
Jenisnumber
Lalai1.7
> 0
Bekalkan ketinggian watak yang dianggarkan dalam meter apabila enable_rigging ialah true; jika tidak, nilai ini tiada kesan.
enable_animationpilihan
Jenisboolean
Lalaifalse
Sama ada model yang telah dipasang rangkanya menerima animasi pratetap, yang memerlukan enable_rigging bernilai true.
animation_action_idpilihan
Jenisinteger
Lalai92
ID pratetap animasi pustaka Meshy, dengan tindakan yang tersedia disenaraikan di https://docs.meshy.ai/en/api/animation-library. Pengesahan dan penggunaan hanya terpakai apabila enable_animation ialah true: nilai di luar [0, 696] ditolak dengan 422, dan "Idle" sepadan dengan `0`.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Suis semakan keselamatan prapemprosesan: true menjadikan semakan keselamatan input prasyarat pemprosesan.
diperlukan
Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail
Output
GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "meshy/v6/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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
"cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
}
}Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
- animation_glb
- object {url, content_type, file_name, file_size} | nullHasil animasi yang mengandungi model 3D sebagai GLB; respons tidak menyertakan hasil ini melainkan enable_animation ialah true.
- animation_fbx
- object {url, content_type, file_name, file_size} | nullHasil animasi yang mengandungi model 3D sebagai FBX; respons tidak menyertakan hasil ini melainkan enable_animation ialah true.
- model_glb
- object {url, content_type, file_name, file_size}Fail GLB yang mengandungi objek 3D yang dijana.
- thumbnail
- object {url, content_type, file_name, file_size} | nullLakaran kecil yang menunjukkan pratonton model yang dijana.
- model_urls
- object {glb, fbx, obj, usdz, blend, stl}Pautan ke model 3D dalam pelbagai format.
- texture_urls
- array of object {base_color, metallic, normal, roughness}Fail tekstur yang diwakili sebagai tatasusunan objek.
- seed
- integer | nullNilai seed yang digunakan semasa penjanaan.
- prompt
- stringPrompt teks yang dibekalkan untuk penjanaan.
- actual_prompt
- string | nullPrompt yang sebenarnya digunakan untuk penjanaan apabila pengembangan prompt didayakan.
- rigged_character_glb
- object {url, content_type, file_name, file_size} | nullHasil pemasangan rangka yang dihantar sebagai fail watak GLB; tiada dalam respons melainkan enable_rigging ialah true.
- rigged_character_fbx
- object {url, content_type, file_name, file_size} | nullHasil pemasangan rangka yang dihantar sebagai fail watak FBX; tiada dalam respons melainkan enable_rigging ialah true.
- basic_animations
- object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimasi asas berjalan dan berlari, disertakan hanya jika enable_rigging ialah true.
- rig_task_id
- string | nullPengecam tugas pemasangan rangka; disertakan hanya jika enable_rigging ialah true.
Varian Meshy 6 lain
Lebih banyak model: Teks ke 3D
Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/meshy/v6/text-to-3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt