Preskoči na vsebino

Meshy 6 · Text to 3D

Integracija

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

Ta zahteva: 0,80 $ 800 API kreditov · ≈ 86,06 ₽ Zaženi na tej strani

Pridobi ključ API
Meshy Besedilo v 3D #text-to-3d

Generator mrež iz besedila v 3D z načinom predogleda ali teksturiranja ter neobveznim PBR, skeletom in animacijo

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.

Napredno texture_prompt · texture_image_url · mode · 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_rigging · enable_animation · enable_safety_checker
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'.

mode privzeto full

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

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/v6/text-to-3d?wait=20 cena → 0,80 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/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 6 · Text to 3D

Iz besedilnega `prompt` do 600 znakov ustvari 3D-model. `mode` izbere neteksturirano geometrijo (`preview`) ali teksturiran rezultat (`full`). `model_type` je lahko standard, lowpoly ali smart-topology, `target_polycount` pa od 100 do 300000; pri smart topology je omejen na 15000. Dodate lahko tudi PBR-zemljevide, pozo, humanoidni skelet in prednastavitev animacije.

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.
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/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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/v6/text-to-3d.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt