Saltar al cuntegna

Meshy V7 Text to 3D

Integrar

ID dal model 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"

Datotecas sco l'exempel: $1,20 1 200 credits API tias datotecas vegnan mesiradas avant l'execuziun Lantschar sin questa pagina

Obtegna ina clav API
Meshy Text a 3D #stylized#transform

Text-a-3D cun Meshy 7: modus preview u cumplet, geometria 2k, PBR, rigging ed animaziun facultativs

Meshy · 3D

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori 88 / 600

Descripziun da l'object da represchentar sco model 3D, limitada a 600 caracters.

mode standard full

Modus da generaziun: 'preview' producescha geometria senza texturas, entant che 'full' producescha in model texturà cumbinond preview e refine.

geometry_resolution

Resoluziun da la geometria da la mesh; las opziuns sustegnidas da Meshy-7 èn standard e 2k.

Avanzà 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

Diriger la texturaziun cun in prompt textual supplementar en il modus 'full'; auters modus na l'utiliseschan betg.

Trametta in datoteca u

Maletg da referenza 2D per la generaziun da texturas, applitgà mo en il modus 'full'.

model_type standard standard

Modus da la mesh 3D: tscherner 'lowpoly' per in resultat low-poly optimà per poligons pli nets; en quest modus ignora Meshy topology, target_polycount e should_remesh. Per in resultat convenziunal cun blers detagls tscherner 'standard', u 'smart-topology' per utilisar Meshy-T2 durant il pass da geometria (preview) e survegnir parts nettas generadas separadamain gia da l'entschatta.

topology standard triangle

Tscherna da la topologia dal model tranter Triangle per detagls geometris e Quad per ina surfatscha pli glischa.

symmetry_mode standard auto

Configuraziun da la simetria applitgada durant la generaziun dal model.

pose_mode standard

Laschar la stringa vida per betg definir la pose dal model generà, u dumandar ina A-pose cun 'a-pose' u ina T-pose cun 't-pose'.

standard 30000

Finamira dal dumber da poligons, limitada a 15,000, sch' model_type è 'smart-topology'. Sche la finamira vegn omessa en quest modus, vegn tschernì il standard pli bass da Meshy da 4,000.

standard 1.7

Furnir in'autezza stimada dal caracter en meters, sche enable_rigging è true; autramain n'ha questa valur nagin effect.

standard 92

ID da l'animaziun preset da la biblioteca Meshy, cun las acziuns disponiblas a https://docs.meshy.ai/en/api/animation-library. Validaziun ed utilisaziun valan mo, sche enable_animation è true: valurs orda [0, 696] vegnan refusadas cun in 422, e "Idle" correspunda a `0`.

Reutilisar quest seed ensemen cun in prompt invarià per reproducir normalmain in resultat anteriur.

POST /run/meshy/v7/text-to-3d?wait=20 calculaziun → $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"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Meshy V7 Text to 3D

Generescha in model 3D dad in `prompt` da fin a 600 caracters, cun `enable_prompt_expansion` facultativ. `mode` returnescha geometria senza textura u in model texturà. Tscherni standard, lowpoly u smart-topology via `model_type`, definescha `target_polycount` da 100 fin 300000, e tscherna standard u 2k `geometry_resolution`. Rigging e preselecziuns d'animaziun pon vegnir agiuntads per caracters umanoids.

Parameters

NumTip StandardPermess Descripziun
promptobligatori
Tipstring
≤ 600 caracters
Descripziun da l'object da represchentar sco model 3D, limitada a 600 caracters.
modeopziunal
Tipenum
Standardfull
previewfull
Modus da generaziun: 'preview' producescha geometria senza texturas, entant che 'full' producescha in model texturà cumbinond preview e refine.
seedopziunal
Tipinteger | null
Reutilisar quest seed ensemen cun in prompt invarià per reproducir normalmain in resultat anteriur.
model_typeopziunal
Tipenum
Standardstandard
standardlowpolysmart-topology
Modus da la mesh 3D: tscherner 'lowpoly' per in resultat low-poly optimà per poligons pli nets; en quest modus ignora Meshy topology, target_polycount e should_remesh. Per in resultat convenziunal cun blers detagls tscherner 'standard', u 'smart-topology' per utilisar Meshy-T2 durant il pass da geometria (preview) e survegnir parts nettas generadas separadamain gia da l'entschatta.
topologyopziunal
Tipenum
Standardtriangle
quadtriangle
Tscherna da la topologia dal model tranter Triangle per detagls geometris e Quad per ina surfatscha pli glischa.
target_polycountopziunal
Tipinteger
Standard30000
100 – 300 000
Finamira dal dumber da poligons, limitada a 15,000, sch' model_type è 'smart-topology'. Sche la finamira vegn omessa en quest modus, vegn tschernì il standard pli bass da Meshy da 4,000.
should_remeshopziunal
Tipboolean
Standardtrue
Saltar il remeshing e retschaiver la mesh triangulara criva cun false; autramain activar la fasa da remesh.
symmetry_modeopziunal
Tipenum
Standardauto
offautoon
Configuraziun da la simetria applitgada durant la generaziun dal model.
enable_pbropziunal
Tipboolean
Standardfalse
Controlla la generaziun da chartas PBR metallic, roughness e normal sper il colur da basa.
is_a_t_poseopziunal
Tipboolean
Standardfalse
Interrupter per la generaziun da la T-pose activà cun true; deprecà en favur da pose_mode.
pose_modeopziunal
Tipenum
Standard
a-poset-pose
Laschar la stringa vida per betg definir la pose dal model generà, u dumandar ina A-pose cun 'a-pose' u ina T-pose cun 't-pose'.
enable_prompt_expansionopziunal
Tipboolean
Standardfalse
Permetta ad in large language model d'enritgir il prompt cun detagls. Questa expansiun mantegna il senn dal prompt.
texture_promptopziunal
Tipstring | null
≤ 600 caracters
Diriger la texturaziun cun in prompt textual supplementar en il modus 'full'; auters modus na l'utiliseschan betg.
texture_image_urlopziunal
Tipurl · image
Maletg da referenza 2D per la generaziun da texturas, applitgà mo en il modus 'full'.
enable_riggingopziunal
Tipboolean
Standardfalse
Rigging umanoid automatic, il pli efficaz per models umanoids cun membra cleramain distinguiblas. L'activaziun rigga il model generà e furnescha animaziuns da basa per ir e currer.
rigging_height_metersopziunal
Tipnumber
Standard1.7
> 0
Furnir in'autezza stimada dal caracter en meters, sche enable_rigging è true; autramain n'ha questa valur nagin effect.
enable_animationopziunal
Tipboolean
Standardfalse
Sche il model rigger survegn in'animaziun preset; quai pretenda che enable_rigging saja true.
animation_action_idopziunal
Tipinteger
Standard92
ID da l'animaziun preset da la biblioteca Meshy, cun las acziuns disponiblas a https://docs.meshy.ai/en/api/animation-library. Validaziun ed utilisaziun valan mo, sche enable_animation è true: valurs orda [0, 696] vegnan refusadas cun in 422, e "Idle" correspunda a `0`.
enable_safety_checkeropziunal
Tipboolean
Standardtrue
Interrupter dal controll da segirezza dal preprocessing: true fa dal controll da segirezza da l'input ina premissa per l'elavuraziun.
geometry_resolutionopziunal
Tipenum
standard2k
Resoluziun da la geometria da la mesh; las opziuns sustegnidas da Meshy-7 èn standard e 2k.
ultra_modeopziunal
Tipboolean
Standardfalse
Opziun deprecada remplazzada da geometry_resolution, che ha prioritad, sch'ellas vegnan omaduas furnidas; utilisar geometry_resolution='2k' empè da quai.
obligatori

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
animation_glb
object {url, content_type, file_name, file_size} | nullResultat d'animaziun che cuntegna il model 3D sco GLB; la resposta ometta quest resultat, sch' enable_animation n'è betg true.
animation_fbx
object {url, content_type, file_name, file_size} | nullResultat d'animaziun che cuntegna il model 3D sco FBX; la resposta ometta quest resultat, sch' enable_animation n'è betg true.
model_glb
object {url, content_type, file_name, file_size}Datoteca GLB che cuntegna l'object 3D generà.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatura che mussa in'antevista dal model generà.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Links al model 3D en differents formats.
texture_urls
array of object {base_color, metallic, normal, roughness}Datotecas da texturas represchentadas sco array d'objects.
seed
integer | nullValur seed utilisada durant la generaziun.
prompt
stringPrompt textual furnì per la generaziun.
actual_prompt
string | nullPrompt effectivamain applitgà a la generaziun, sch' l'expansiun dal prompt era activada.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullResultat dal rigging furnì sco datoteca da caracter GLB; absent da la resposta, sch' enable_rigging n'è betg true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullResultat dal rigging furnì sco datoteca da caracter FBX; absent da la resposta, sch' enable_rigging n'è betg true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimaziuns da basa per ir e currer, includidas mo, sch' enable_rigging è true.
rig_task_id
string | nullIdentificaturs per la lavur da rigging; includì mo, sch' enable_rigging è true.

Dapli models: Text a 3D

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/meshy/v7/text-to-3d.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt