Aqbeż għall-kontenut

Meshy V7 Text to 3D

Integra

Id tal-mudell 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"

Fajls bħall-eżempju: $1.20 1,200 krediti tal-API il-fajls tiegħek jitkejlu qabel it-tħaddim Ħaddmu f’din il-paġna

Ikseb ċavetta API
Meshy Test għal 3D #stylized#transform

Minn test għal 3D b’Meshy 7: modalità preview jew full, ġeometrija 2k u għażliet PBR, rigging u animazzjoni

Meshy · 3D

L-ewwel riżultat tiegħek jidher hawn

Ibni talba hawn taħt u ħaddimha biċ-ċavetta API tiegħek. L-outputs jiġu kkupjati fil-ħażna tagħna, miżmuma għal dejjem jew 7 ijiem b’xejn.

Ibni talba

Il-kontrolli jiġu ġġenerati mill-iskema tal-mudell. Il-kodiċi u l-prezz jaġġornaw hekk kif tibdilhom.

•meħtieġ 88 / 600

Deskrizzjoni tal-oġġett li għandu jiġi rrappreżentat bħala mudell 3D, limitata għal 600 karattru.

mode prestabbilit full

Modalità tal-ġenerazzjoni: 'preview' tipproduċi ġeometrija mingħajr tessuti, filwaqt li 'full' tipproduċi mudell b’tessuti billi tgħaqqad preview u refine.

geometry_resolution

Riżoluzzjoni tal-ġeometrija tal-mesh; l-għażliet appoġġjati ta’ Meshy-7 huma standard u 2k.

Avvanzat 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

Iggwida t-texturing bi prompt tat-test addizzjonali fil-modalità 'full'; il-modalitajiet l-oħra ma jużawhx.

Waqqa’ fajl, jew

Immaġni ta’ referenza 2D għall-ġenerazzjoni tat-texture, applikata biss fil-modalità 'full'.

model_type prestabbilit standard

Modalità tal-mesh 3D: agħżel 'lowpoly' għal riżultat low-poly ottimizzat għal poligoni aktar nodfa; f’din il-modalità Meshy tinjora topology, target_polycount, u should_remesh. Għal riżultat konvenzjonali b’dettall għoli agħżel 'standard', jew agħżel 'smart-topology' biex tuża Meshy-T2 matul il-pass tal-ġeometrija (preview) u tikseb partijiet nodfa ġġenerati separatament mill-bidu.

topology prestabbilit triangle

Għażla tat-topoloġija tal-mudell bejn Triangle għal dettall ġeometriku u Quad għal lixxija tal-wiċċ.

symmetry_mode prestabbilit auto

Setting tas-simetrija applikat waqt il-ġenerazzjoni tal-mudell.

pose_mode prestabbilit

Ħalli s-stringa vojta biex ma tispeċifikax il-pose tal-mudell iġġenerat, jew itlob A-pose b’'a-pose' jew T-pose b’'t-pose'.

prestabbilit 30000

Mira tal-għadd tal-poligoni, limitata għal 15,000 meta model_type ikun 'smart-topology'. Jekk il-mira titħalla barra f’dik il-modalità, jintgħażel il-valur prestabbilit aktar baxx ta’ Meshy, 4,000.

prestabbilit 1.7

Ipprovdi għoli stmat tal-karattru f’metri meta enable_rigging ikun true; inkella, dan il-valur ma jkollu l-ebda effett.

prestabbilit 92

ID tal-animazzjoni preset tal-librerija Meshy, bl-azzjonijiet disponibbli elenkati f’https://docs.meshy.ai/en/api/animation-library. Il-validazzjoni u l-użu japplikaw biss meta enable_animation ikun true: valuri barra [0, 696] jiġu rrifjutati b’422, u "Idle" jikkorrispondi għal `0`.

Uża dan is-seed flimkien ma’ prompt mhux mibdul biex normalment tirriproduċi riżultat preċedenti.

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

Ħaddem din it-talba

Iċ-ċavetta tiegħek tibqa’ f’dan il-browser: tintbagħat biss lid-Doitong API u tiġi ssejvjata (localStorage) biss jekk timmarka Ftakar. Ikseb ċavetta API

Dwar Meshy V7 Text to 3D

Jiġġenera mudell 3D minn `prompt` sa 600 karattru, b’`enable_prompt_expansion` fakultattiv. `mode` jirritorna ġeometrija mingħajr texture jew mudell b’texture. Agħżel standard, lowpoly jew smart-topology permezz ta’ `model_type`, issettja `target_polycount` minn 100 sa 300000, u agħżel standard jew 2k għal `geometry_resolution`. Jistgħu jiżdiedu rigging u issettjar tal-animazzjoni minn qabel għal karattri umanojdi.

Parametri

IsemTip PrestabbilitPermess Deskrizzjoni
promptmeħtieġ
Tipstring
≤ 600 karattri
Deskrizzjoni tal-oġġett li għandu jiġi rrappreżentat bħala mudell 3D, limitata għal 600 karattru.
modemhux obbligatorju
Tipenum
Prestabbilitfull
previewfull
Modalità tal-ġenerazzjoni: 'preview' tipproduċi ġeometrija mingħajr tessuti, filwaqt li 'full' tipproduċi mudell b’tessuti billi tgħaqqad preview u refine.
seedmhux obbligatorju
Tipinteger | null
Uża dan is-seed flimkien ma’ prompt mhux mibdul biex normalment tirriproduċi riżultat preċedenti.
model_typemhux obbligatorju
Tipenum
Prestabbilitstandard
standardlowpolysmart-topology
Modalità tal-mesh 3D: agħżel 'lowpoly' għal riżultat low-poly ottimizzat għal poligoni aktar nodfa; f’din il-modalità Meshy tinjora topology, target_polycount, u should_remesh. Għal riżultat konvenzjonali b’dettall għoli agħżel 'standard', jew agħżel 'smart-topology' biex tuża Meshy-T2 matul il-pass tal-ġeometrija (preview) u tikseb partijiet nodfa ġġenerati separatament mill-bidu.
topologymhux obbligatorju
Tipenum
Prestabbilittriangle
quadtriangle
Għażla tat-topoloġija tal-mudell bejn Triangle għal dettall ġeometriku u Quad għal lixxija tal-wiċċ.
target_polycountmhux obbligatorju
Tipinteger
Prestabbilit30000
100 – 300,000
Mira tal-għadd tal-poligoni, limitata għal 15,000 meta model_type ikun 'smart-topology'. Jekk il-mira titħalla barra f’dik il-modalità, jintgħażel il-valur prestabbilit aktar baxx ta’ Meshy, 4,000.
should_remeshmhux obbligatorju
Tipboolean
Prestabbilittrue
Aqbeż ir-remeshing u rċievi l-mesh trijangolari mhux ipproċessat billi tissettja dan għal false; inkella, attiva l-fażi tar-remesh.
symmetry_modemhux obbligatorju
Tipenum
Prestabbilitauto
offautoon
Setting tas-simetrija applikat waqt il-ġenerazzjoni tal-mudell.
enable_pbrmhux obbligatorju
Tipboolean
Prestabbilitfalse
Jikkontrolla l-ġenerazzjoni ta’ mapep PBR metalliċi, ta’ roughness u normali flimkien mal-kulur bażi.
is_a_t_posemhux obbligatorju
Tipboolean
Prestabbilitfalse
Swiċċ tal-ġenerazzjoni tat-T-pose attivat b’true; deprecated favur pose_mode.
pose_modemhux obbligatorju
Tipenum
Prestabbilit
a-poset-pose
Ħalli s-stringa vojta biex ma tispeċifikax il-pose tal-mudell iġġenerat, jew itlob A-pose b’'a-pose' jew T-pose b’'t-pose'.
enable_prompt_expansionmhux obbligatorju
Tipboolean
Prestabbilitfalse
Ħalli mudell lingwistiku kbir jarrikkixxi l-prompt bid-dettalji. L-attivazzjoni ta’ din l-espansjoni ma tbiddilx it-tifsira tal-prompt.
texture_promptmhux obbligatorju
Tipstring | null
≤ 600 karattri
Iggwida t-texturing bi prompt tat-test addizzjonali fil-modalità 'full'; il-modalitajiet l-oħra ma jużawhx.
texture_image_urlmhux obbligatorju
Tipurl · image
Immaġni ta’ referenza 2D għall-ġenerazzjoni tat-texture, applikata biss fil-modalità 'full'.
enable_riggingmhux obbligatorju
Tipboolean
Prestabbilitfalse
Rigging awtomatiku umanojdi, l-aktar effettiv għal mudelli umanojdi li r-riġlejn tagħhom jintgħarfu b’mod ċar. L-attivazzjoni tiegħu tagħmel ir-rigging tal-mudell iġġenerat u tipprovdi animazzjonijiet bażiċi għall-mixi u t-tmexxija.
rigging_height_metersmhux obbligatorju
Tipnumber
Prestabbilit1.7
> 0
Ipprovdi għoli stmat tal-karattru f’metri meta enable_rigging ikun true; inkella, dan il-valur ma jkollu l-ebda effett.
enable_animationmhux obbligatorju
Tipboolean
Prestabbilitfalse
Jekk il-mudell rigged jirċevix animazzjoni preset, li teħtieġ li enable_rigging ikun true.
animation_action_idmhux obbligatorju
Tipinteger
Prestabbilit92
ID tal-animazzjoni preset tal-librerija Meshy, bl-azzjonijiet disponibbli elenkati f’https://docs.meshy.ai/en/api/animation-library. Il-validazzjoni u l-użu japplikaw biss meta enable_animation ikun true: valuri barra [0, 696] jiġu rrifjutati b’422, u "Idle" jikkorrispondi għal `0`.
enable_safety_checkermhux obbligatorju
Tipboolean
Prestabbilittrue
Swiċċ tal-kontroll tas-sikurezza tal-ipproċessar: true jagħmel kontroll tas-sikurezza tal-input prerekwiżit għall-ipproċessar.
geometry_resolutionmhux obbligatorju
Tipenum
standard2k
Riżoluzzjoni tal-ġeometrija tal-mesh; l-għażliet appoġġjati ta’ Meshy-7 huma standard u 2k.
ultra_modemhux obbligatorju
Tipboolean
Prestabbilitfalse
Għażla deprecated sostitwita minn geometry_resolution, li tieħu preċedenza jekk it-tnejn jiġu pprovduti; uża geometry_resolution='2k' minflok.
meħtieġ

Il-parametri tal-fajls jaċċettaw URL pubbliku https://, URI data: sa 10 MB, jew file_url ta’ upload. Fajls

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"
  }
}
Il-fajls tiegħek, l-għażla tiegħekKull outputs[].url huwa kopja fil-ħażna tagħna: miżmuma għal dejjem (imħallsa għal kull GB-xahar) jew 7 ijiem b’xejn, skont l-issettjar tal-kont tiegħek jew ?storage=.
L-istess struttura fuq kull mudelltype, url, content_type, width, height u duration, kemm għall-immaġnijiet kif ukoll għall-vidjo u l-awdjo. output huwa l-oġġett tar-riżultat tal-mudell innifsu.
Oqsma tal-output
animation_glb
object {url, content_type, file_name, file_size} | nullRiżultat tal-animazzjoni li fih il-mudell 3D bħala GLB; ir-rispons ma jinkludix dan ir-riżultat sakemm enable_animation ma jkunx true.
animation_fbx
object {url, content_type, file_name, file_size} | nullRiżultat tal-animazzjoni li fih il-mudell 3D bħala FBX; ir-rispons ma jinkludix dan ir-riżultat sakemm enable_animation ma jkunx true.
model_glb
object {url, content_type, file_name, file_size}Fajl GLB li fih l-oġġett 3D iġġenerat.
thumbnail
object {url, content_type, file_name, file_size} | nullThumbnail li juri preview tal-mudell iġġenerat.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Links għall-mudell 3D f'diversi formati.
texture_urls
array of object {base_color, metallic, normal, roughness}Fajls tat-texture rrappreżentati bħala firxa ta’ oġġetti.
seed
integer | nullValur taż-żerriegħa użat waqt il-ġenerazzjoni.
prompt
stringPrompt tat-test ipprovdut għall-ġenerazzjoni.
actual_prompt
string | nullPrompt applikat fil-fatt għall-ġenerazzjoni meta l-espansjoni tal-prompt kienet attivata.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRiżultat tar-rigging ikkunsinnat bħala fajl ta’ karattru GLB; assenti mir-rispons sakemm enable_rigging ma jkunx true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRiżultat tar-rigging ikkunsinnat bħala fajl ta’ karattru FBX; assenti mir-rispons sakemm enable_rigging ma jkunx true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimazzjonijiet bażiċi tal-mixi u t-tmexxija, inklużi biss jekk enable_rigging ikun true.
rig_task_id
string | nullIdentifikatur għall-kompitu tar-rigging; inkluż biss jekk enable_rigging ikun true.

Aktar mudelli: Test għal 3D

Għall-aġenti tal-AI: din il-paġna bħala Markdown tinsab fuq https://doitong.com/mt/developers/models/meshy/v7/text-to-3d.md. Il-mudelli u l-gwidi kollha: https://doitong.com/developers/llms.txt