Vai al contenuto

Meshy V7 Text to 3D

Integra

ID del modello 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

File come nell'esempio: 1,20 $ 1200 crediti API i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Meshy Da testo a 3D #stylized#transform

Conversione testo-3D con Meshy 7: modalità preview o full, geometria 2k e opzioni PBR, rigging e animazione

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.

•obbligatorio 88 / 600

Descrizione dell'oggetto da rappresentare come modello 3D, limitata a 600 caratteri.

mode predefinito full

Modalità di generazione: 'preview' produce la geometria senza texture, mentre 'full' produce un modello texturizzato combinando preview e refine.

geometry_resolution

Risoluzione della geometria della mesh; le opzioni Meshy-7 supportate sono standard e 2k.

Avanzate 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
0 / 600

Guidare la texturizzazione con un prompt testuale aggiuntivo in modalità 'full'; le altre modalità non lo utilizzano.

Trascina un file oppure

Immagine di riferimento 2D per la generazione delle texture, applicata solo in modalità 'full'.

model_type predefinito standard

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.

topology predefinito triangle

Scelta della topologia del modello tra Triangle per i dettagli geometrici e Quad per la levigatezza della superficie.

symmetry_mode predefinito auto

Impostazione della simmetria applicata durante la generazione del modello.

pose_mode predefinito

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'.

predefinito 30000

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.

predefinito 1.7

Fornire un'altezza stimata del personaggio in metri quando enable_rigging è true; altrimenti questo valore non ha effetto.

predefinito 92

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`.

Riutilizzare questo seed insieme a un prompt invariato per riprodurre generalmente un risultato precedente.

POST /run/meshy/v7/text-to-3d?wait=20 preventivo → 1,20 $
# 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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 V7 Text to 3D

Genera un modello 3D da un `prompt` di massimo 600 caratteri, con `enable_prompt_expansion` opzionale. `mode` restituisce geometria non texturizzata oppure un modello texturizzato. Scegli standard, lowpoly o smart-topology tramite `model_type`, imposta `target_polycount` da 100 a 300000 e seleziona `geometry_resolution` standard o 2k. Per i personaggi umanoidi è possibile aggiungere rigging e 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.
geometry_resolutionfacoltativo
Tipoenum
standard2k
Risoluzione della geometria della mesh; le opzioni Meshy-7 supportate sono standard e 2k.
ultra_modefacoltativo
Tipoboolean
Predefinitofalse
Opzione obsoleta sostituita da geometry_resolution, che prevale se vengono fornite entrambe; usare geometry_resolution='2k'.
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/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.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.

Altri modelli: Da testo a 3D

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/meshy/v7/text-to-3d.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt