Preskoči na vsebino

Meshy V7 Text to 3D

Integracija

ID modela 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"

Datoteke, kot je primer: 1,20 $ 1200 API kreditov vaše datoteke se izmerijo pred zagonom Zaženi na tej strani

Pridobi ključ API
Meshy Besedilo v 3D #stylized#transform

Pretvorba besedila v 3D z Meshy 7: način predogleda ali polni način, geometrija 2k ter možnosti PBR, skeleta in animacije

Meshy · 3D

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno 88 / 600

Opis predmeta, ki ga je treba predstaviti kot 3D-model, omejen na 600 znakov.

mode privzeto full

Način generiranja: 'preview' ustvari geometrijo brez tekstur, 'full' pa teksturiran model s kombiniranjem predogleda in izboljšave.

geometry_resolution

Ločljivost geometrije mreže; podprti možnosti Meshy-7 sta standard in 2k.

Napredno 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

V načinu 'full' usmerjajte teksturiranje z dodatnim besedilnim pozivom; drugi načini ga ne uporabljajo.

Spustite datoteko ali

2D-referenčna slika za generiranje tekstur, uporabljena samo v načinu 'full'.

model_type privzeto standard

Način 3D-mreže: izberite 'lowpoly' za rezultat z malo poligoni, optimiziran za čistejše poligone; v tem načinu Meshy prezre topology, target_polycount in should_remesh. Za običajen rezultat z veliko podrobnostmi izberite 'standard' ali 'smart-topology' za uporabo Meshy-T2 med korakom geometrije (preview) in čiste dele, ustvarjene ločeno že od začetka.

topology privzeto triangle

Izbira topologije modela med Triangle za geometrijske podrobnosti in Quad za gladkost površine.

symmetry_mode privzeto auto

Nastavitev simetrije, uporabljena pri generiranju modela.

pose_mode privzeto

Pustite niz prazen, če ne želite določiti poze ustvarjenega modela, ali zahtevajte pozo A z 'a-pose' oziroma pozo T s 't-pose'.

privzeto 30000

Ciljno število poligonov, omejeno na 15,000, ko je model_type 'smart-topology'. Če cilj v tem načinu izpustite, se izbere Meshyjeva nižja privzeta vrednost 4,000.

privzeto 1.7

Podajte ocenjeno višino značaja v metrih, ko je enable_rigging true; sicer ta vrednost nima učinka.

privzeto 92

ID prednastavitve animacije knjižnice Meshy; razpoložljiva dejanja so navedena na https://docs.meshy.ai/en/api/animation-library. Preverjanje in uporaba veljata samo, če je enable_animation true: vrednosti zunaj [0, 696] se zavrnejo z 422, "Idle" pa ustreza `0`.

To seme uporabite z nespremenjenim pozivom za običajno ponovitev prejšnjega rezultata.

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

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Meshy V7 Text to 3D

Iz `prompt` do 600 znakov ustvari 3D-model z neobveznim `enable_prompt_expansion`. `mode` vrne neteksturirano geometrijo ali teksturiran model. Z `model_type` izberite standard, lowpoly ali smart-topology, `target_polycount` nastavite od 100 do 300000 in `geometry_resolution` izberite kot standard ali 2k. Humanoidnim likom lahko dodate skelet in prednastavitve animacij.

Parametri

ImeVrsta PrivzetoDovoljeno Opis
promptobvezno
Vrstastring
≤ 600 znakov
Opis predmeta, ki ga je treba predstaviti kot 3D-model, omejen na 600 znakov.
modeneobvezno
Vrstaenum
Privzetofull
previewfull
Način generiranja: 'preview' ustvari geometrijo brez tekstur, 'full' pa teksturiran model s kombiniranjem predogleda in izboljšave.
seedneobvezno
Vrstainteger | null
To seme uporabite z nespremenjenim pozivom za običajno ponovitev prejšnjega rezultata.
model_typeneobvezno
Vrstaenum
Privzetostandard
standardlowpolysmart-topology
Način 3D-mreže: izberite 'lowpoly' za rezultat z malo poligoni, optimiziran za čistejše poligone; v tem načinu Meshy prezre topology, target_polycount in should_remesh. Za običajen rezultat z veliko podrobnostmi izberite 'standard' ali 'smart-topology' za uporabo Meshy-T2 med korakom geometrije (preview) in čiste dele, ustvarjene ločeno že od začetka.
topologyneobvezno
Vrstaenum
Privzetotriangle
quadtriangle
Izbira topologije modela med Triangle za geometrijske podrobnosti in Quad za gladkost površine.
target_polycountneobvezno
Vrstainteger
Privzeto30000
100 – 300.000
Ciljno število poligonov, omejeno na 15,000, ko je model_type 'smart-topology'. Če cilj v tem načinu izpustite, se izbere Meshyjeva nižja privzeta vrednost 4,000.
should_remeshneobvezno
Vrstaboolean
Privzetotrue
Preskočite ponovno mreženje in prejmite surovo trikotno mrežo z nastavitvijo false; sicer omogočite fazo ponovnega mreženja.
symmetry_modeneobvezno
Vrstaenum
Privzetoauto
offautoon
Nastavitev simetrije, uporabljena pri generiranju modela.
enable_pbrneobvezno
Vrstaboolean
Privzetofalse
Določa generiranje kovinskih, hrapavostnih in normalnih PBR-zemljevidov poleg osnovne barve.
is_a_t_poseneobvezno
Vrstaboolean
Privzetofalse
Stikalo za generiranje v pozi T, aktivirano z true; zastarelo v korist pose_mode.
pose_modeneobvezno
Vrstaenum
Privzeto
a-poset-pose
Pustite niz prazen, če ne želite določiti poze ustvarjenega modela, ali zahtevajte pozo A z 'a-pose' oziroma pozo T s 't-pose'.
enable_prompt_expansionneobvezno
Vrstaboolean
Privzetofalse
Velikemu jezikovnemu modelu dovoli obogatitev poziva s podrobnostmi. Ta razširitev ne spremeni pomena poziva.
texture_promptneobvezno
Vrstastring | null
≤ 600 znakov
V načinu 'full' usmerjajte teksturiranje z dodatnim besedilnim pozivom; drugi načini ga ne uporabljajo.
texture_image_urlneobvezno
Vrstaurl · image
2D-referenčna slika za generiranje tekstur, uporabljena samo v načinu 'full'.
enable_riggingneobvezno
Vrstaboolean
Privzetofalse
Samodejno humanoidno opremljanje, najučinkovitejše pri humanoidnih modelih z jasno razločljivimi okončinami. Če ga omogočite, se ustvarjeni model opremi in dodata se osnovni animaciji hoje in teka.
rigging_height_metersneobvezno
Vrstanumber
Privzeto1.7
> 0
Podajte ocenjeno višino značaja v metrih, ko je enable_rigging true; sicer ta vrednost nima učinka.
enable_animationneobvezno
Vrstaboolean
Privzetofalse
Določa, ali opremljeni model prejme prednastavljeno animacijo; zanjo mora biti enable_rigging true.
animation_action_idneobvezno
Vrstainteger
Privzeto92
ID prednastavitve animacije knjižnice Meshy; razpoložljiva dejanja so navedena na https://docs.meshy.ai/en/api/animation-library. Preverjanje in uporaba veljata samo, če je enable_animation true: vrednosti zunaj [0, 696] se zavrnejo z 422, "Idle" pa ustreza `0`.
enable_safety_checkerneobvezno
Vrstaboolean
Privzetotrue
Stikalo za varnostno preverjanje predobdelave: true pomeni, da je varnostno preverjanje vhoda predpogoj za obdelavo.
geometry_resolutionneobvezno
Vrstaenum
standard2k
Ločljivost geometrije mreže; podprti možnosti Meshy-7 sta standard in 2k.
ultra_modeneobvezno
Vrstaboolean
Privzetofalse
Zastarela možnost, nadomeščena z geometry_resolution, ki ima prednost, če sta podani obe; namesto tega uporabite geometry_resolution='2k'.
obvezno

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
animation_glb
object {url, content_type, file_name, file_size} | nullRezultat animacije, ki vsebuje 3D-model kot GLB; odgovor ga izpusti, razen če je enable_animation true.
animation_fbx
object {url, content_type, file_name, file_size} | nullRezultat animacije, ki vsebuje 3D-model kot FBX; odgovor ga izpusti, razen če je enable_animation true.
model_glb
object {url, content_type, file_name, file_size}Datoteka GLB z ustvarjenim 3D-objektom.
thumbnail
object {url, content_type, file_name, file_size} | nullSličica s predogledom ustvarjenega modela.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Povezave do 3D-modela v različnih oblikah.
texture_urls
array of object {base_color, metallic, normal, roughness}Datoteke tekstur, predstavljene kot polje objektov.
seed
integer | nullVrednost semena, uporabljena med generiranjem.
prompt
stringBesedilni poziv za generiranje.
actual_prompt
string | nullPoziv, dejansko uporabljen pri generiranju, ko je bilo razširjanje poziva omogočeno.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRezultat opremljanja, vrnjen kot datoteka značaja GLB; v odgovoru manjka, razen če je enable_rigging true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRezultat opremljanja, vrnjen kot datoteka značaja FBX; v odgovoru manjka, razen če je enable_rigging true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullOsnovni animaciji hoje in teka, vključeni samo, če je enable_rigging true.
rig_task_id
string | nullIdentifikator opravila opremljanja; vključen samo, če je enable_rigging true.

Več modelov: Besedilo v 3D

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/meshy/v7/text-to-3d.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt