3D
Meshy 6 · Image to 3D Varianti: 2
a partire da 0,80 $
800 crediti API
Meshy 6 · Text to 3D
Integra
ID del modello
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/it/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"
}
}Chiama il modello Meshy 6 · Text to 3D (meshy/v6/text-to-3d) tramite Doitong API. Documentazione per gli agenti: https://doitong.com/it/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"
}
Se lo stato della risposta è "queued" o "running", interroga GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 finché non diventa "succeeded"; i file si trovano in outputs[].url. POST https://api.doitong.com/v1/quote/meshy/v6/text-to-3d con lo stesso body restituisce il prezzo esatto prima dell'esecuzione.Questa richiesta: 0,80 $ 800 crediti API Esegui in questa pagina
La tua nuova chiave API. Viene mostrata solo ora ed è già presente nel codice e nel campo della chiave API qui sotto. Mantienila segreta: non inserirla mai nel codice eseguito in un browser.
Meshy · 3D
Il tuo primo risultato apparirà qui
Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.
Crea una richiesta
I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.
POST
/run/meshy/v6/text-to-3d?wait=20
preventivo → 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
}
}
}Esegui questa richiesta
La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API
Informazioni su Meshy 6 · Text to 3D
Costruisce un modello 3D da un `prompt` testuale di massimo 600 caratteri. `mode` sceglie la geometria non texturizzata (`preview`) o un risultato texturizzato (`full`). `model_type` può essere standard, lowpoly o smart-topology e `target_polycount` varia da 100 a 300000, con smart topology limitata a 15000. Può inoltre aggiungere mappe PBR, una posa, rigging umanoide e un preset di animazione.
Parametri
NomeTipo
PredefinitoConsentiti
Descrizione
promptobbligatorio
Tipostring
≤ 600 caratteri
Descrizione dell'oggetto da rappresentare come modello 3D, limitata a 600 caratteri.
modefacoltativo
Tipoenum
Predefinitofull
previewfull
Modalità di generazione: 'preview' produce la geometria senza texture, mentre 'full' produce un modello texturizzato combinando preview e refine.
seedfacoltativo
Tipointeger | null
Riutilizzare questo seed insieme a un prompt invariato per riprodurre generalmente un risultato precedente.
model_typefacoltativo
Tipoenum
Predefinitostandard
standardlowpolysmart-topology
Modalità mesh 3D: scegliere 'lowpoly' per un risultato low-poly ottimizzato per poligoni più puliti; in questa modalità Meshy ignora topology, target_polycount e should_remesh. Per un risultato convenzionale ad alto dettaglio scegliere 'standard', oppure scegliere 'smart-topology' per usare Meshy-T2 durante la fase di geometria (preview) e ottenere parti pulite generate separatamente fin dall'inizio.
topologyfacoltativo
Tipoenum
Predefinitotriangle
quadtriangle
Scelta della topologia del modello tra Triangle per i dettagli geometrici e Quad per la levigatezza della superficie.
target_polycountfacoltativo
Tipointeger
Predefinito30000
100 – 300.000
Obiettivo del numero di poligoni, limitato a 15,000 quando model_type è 'smart-topology'. Omettendo l'obiettivo in tale modalità si seleziona il valore predefinito inferiore di Meshy, pari a 4,000.
should_remeshfacoltativo
Tipoboolean
Predefinitotrue
Saltare il remeshing e ricevere la mesh triangolare grezza impostando questo valore su false; altrimenti abilitare la fase di remesh.
symmetry_modefacoltativo
Tipoenum
Predefinitoauto
offautoon
Impostazione della simmetria applicata durante la generazione del modello.
enable_pbrfacoltativo
Tipoboolean
Predefinitofalse
Controlla la generazione delle mappe PBR metallic, roughness e normal insieme al colore di base.
is_a_t_posefacoltativo
Tipoboolean
Predefinitofalse
Interruttore per la generazione della posa a T, attivato da true; obsoleto a favore di pose_mode.
pose_modefacoltativo
Tipoenum
Predefinito
a-poset-pose
Lasciare la stringa vuota per non specificare la posa del modello generato, oppure richiedere una posa ad A con 'a-pose' o una posa a T con 't-pose'.
enable_prompt_expansionfacoltativo
Tipoboolean
Predefinitofalse
Consente a un modello linguistico di grandi dimensioni di arricchire il prompt con dettagli. L'abilitazione di questa espansione lascia invariato il significato del prompt.
texture_promptfacoltativo
Tipostring | null
≤ 600 caratteri
Guidare la texturizzazione con un prompt testuale aggiuntivo in modalità 'full'; le altre modalità non lo utilizzano.
texture_image_urlfacoltativo
Tipourl · image
Immagine di riferimento 2D per la generazione delle texture, applicata solo in modalità 'full'.
enable_riggingfacoltativo
Tipoboolean
Predefinitofalse
Rigging umanoide automatico, più efficace per modelli umanoidi i cui arti siano chiaramente distinguibili. Abilitandolo si applica il rigging al modello generato e si forniscono animazioni di base per camminata e corsa.
rigging_height_metersfacoltativo
Tiponumber
Predefinito1.7
> 0
Fornire un'altezza stimata del personaggio in metri quando enable_rigging è true; altrimenti questo valore non ha effetto.
enable_animationfacoltativo
Tipoboolean
Predefinitofalse
Indica se il modello sottoposto a rigging riceve un'animazione preimpostata, che richiede enable_rigging impostato su true.
animation_action_idfacoltativo
Tipointeger
Predefinito92
ID del preset di animazione della libreria Meshy, con le azioni disponibili elencate all'indirizzo https://docs.meshy.ai/en/api/animation-library. La convalida e l'utilizzo si applicano solo quando enable_animation è true: i valori esterni a [0, 696] vengono rifiutati con un 422 e "Idle" corrisponde a `0`.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Interruttore del controllo di sicurezza preliminare: true rende il controllo di sicurezza dell'input un prerequisito per l'elaborazione.
obbligatorio
I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File
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"
}
}I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
- animation_glb
- object {url, content_type, file_name, file_size} | nullRisultato dell'animazione contenente il modello 3D come GLB; la risposta omette questo risultato a meno che enable_animation non sia true.
- animation_fbx
- object {url, content_type, file_name, file_size} | nullRisultato dell'animazione contenente il modello 3D come FBX; la risposta omette questo risultato a meno che enable_animation non sia true.
- model_glb
- object {url, content_type, file_name, file_size}File GLB contenente l'oggetto 3D generato.
- thumbnail
- object {url, content_type, file_name, file_size} | nullMiniatura che mostra un'anteprima del modello generato.
- model_urls
- object {glb, fbx, obj, usdz, blend, stl}Collegamenti al modello 3D in vari formati.
- texture_urls
- array of object {base_color, metallic, normal, roughness}File di texture rappresentati come array di oggetti.
- seed
- integer | nullValore seed usato durante la generazione.
- prompt
- stringPrompt testuale fornito per la generazione.
- actual_prompt
- string | nullPrompt effettivamente applicato alla generazione quando l'espansione del prompt era abilitata.
- rigged_character_glb
- object {url, content_type, file_name, file_size} | nullRisultato del rigging fornito come file del personaggio GLB; assente dalla risposta a meno che enable_rigging non sia true.
- rigged_character_fbx
- object {url, content_type, file_name, file_size} | nullRisultato del rigging fornito come file del personaggio FBX; assente dalla risposta a meno che enable_rigging non sia true.
- basic_animations
- object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimazioni di base per camminata e corsa, incluse solo se enable_rigging è true.
- rig_task_id
- string | nullIdentificatore dell'attività di rigging; incluso solo se enable_rigging è true.
Altre varianti di Meshy 6
Altri modelli: Da testo a 3D
Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/meshy/v6/text-to-3d.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt