Ugrás a tartalomhoz

Meshy 6 · Text to 3D

Integráció

Modellazonosító 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"

Ez a kérés: 0,80 $ 800 API-jóváírás · ≈ 86,06 ₽ Futtatás ezen az oldalon

API-kulcs beszerzése
Meshy Szövegből 3D #text-to-3d

Szövegből 3D-hálót generáló modell előnézeti vagy textúrázott módokkal, opcionális PBR-rel, riggeléssel és animációval

Meshy · 3D

Az első eredményed itt jelenik meg

Állíts össze egy kérést alább, majd futtasd az API-kulcsoddal. A kimeneteket a tárhelyünkre másoljuk, és örökre vagy 7 nap ideig ingyenesen őrizzük meg.

Kérés összeállítása

A vezérlők a modell sémájából jönnek létre. A kód és az ár a módosításokkal együtt frissül.

•kötelező 88 / 600

A 3D-modellként megjelenítendő objektum leírása, legfeljebb 600 karakterben.

Speciális 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

Textúrázás irányítása további szöveges prompttal 'full' módban; más módok nem használják.

Húzz egy fájlt ide, vagy

Textúrageneráláshoz használt 2D-referenciakép, csak 'full' módban.

mode alapértelmezett: full

Generálási mód: a 'preview' textúrák nélküli geometriát, a 'full' pedig a preview és refine kombinálásával textúrázott modellt ad.

model_type alapértelmezett: standard

3D-hálómód: a 'lowpoly' tisztább poligonokra optimalizált, alacsony poligonszámú eredményt ad; ebben a módban a Meshy figyelmen kívül hagyja a topology, target_polycount és should_remesh értékét. Részletes eredményhez válassza a 'standard' módot, vagy a 'smart-topology' módot a Meshy-T2 használatához a geometriai (preview) lépésben.

topology alapértelmezett: triangle

Modelltopológia: Triangle a geometriai részletességhez, Quad a felületi simasághoz.

symmetry_mode alapértelmezett: auto

A modellgenerálás közben alkalmazott szimmetriabeállítás.

pose_mode alapértelmezett:

Hagyja üresen a karakter pózának megadásának mellőzéséhez, vagy kérjen A-pózt 'a-pose', illetve T-pózt 't-pose' értékkel.

alapértelmezett: 30000

Poligonszám-cél, amelyet a 'smart-topology' model_type esetén 15,000-ben korlátoz. Ebben a módban a célérték kihagyása a Meshy alacsonyabb, 4,000-es alapértékét választja.

alapértelmezett: 1.7

Becsült karaktermagasság méterben, ha az enable_rigging true; egyébként nincs hatása.

alapértelmezett: 92

Meshy-könyvtári animációs előbeállítás azonosítója; az elérhető műveletek a https://docs.meshy.ai/en/api/animation-library címen találhatók. Az ellenőrzés és használat csak akkor érvényes, ha az enable_animation true: a [0, 696] tartományon kívüli értékeket 422-es hibával elutasítja, az "Idle" pedig `0`.

Ezt a magot változatlan prompttal újrahasználva általában reprodukálható egy korábbi eredmény.

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

Kérés futtatása

A kulcsod ebben a böngészőben marad: csak a Doitong API-nak küldjük el, és csak akkor mentjük a localStorage-ba, ha bejelölöd az Emlékezz rám lehetőséget. API-kulcs igénylése

A(z) Meshy 6 · Text to 3D bemutatása

Legfeljebb 600 karakteres szöveges `prompt` alapján készít 3D-modellt. A `mode` textúrázatlan geometriát (`preview`) vagy textúrázott eredményt (`full`) választ. A `model_type` lehet standard, lowpoly vagy smart-topology, a `target_polycount` pedig 100 és 300000 között mozog, smart topology esetén legfeljebb 15000 értékkel. PBR-térképek, póz, humanoid riggelés és animációs előbeállítás is hozzáadható.

Paraméterek

NévTípus AlapértelmezettEngedélyezett Leírás
promptkötelező
Típusstring
≤ 600 karakter
A 3D-modellként megjelenítendő objektum leírása, legfeljebb 600 karakterben.
modenem kötelező
Típusenum
Alapértelmezettfull
previewfull
Generálási mód: a 'preview' textúrák nélküli geometriát, a 'full' pedig a preview és refine kombinálásával textúrázott modellt ad.
seednem kötelező
Típusinteger | null
Ezt a magot változatlan prompttal újrahasználva általában reprodukálható egy korábbi eredmény.
model_typenem kötelező
Típusenum
Alapértelmezettstandard
standardlowpolysmart-topology
3D-hálómód: a 'lowpoly' tisztább poligonokra optimalizált, alacsony poligonszámú eredményt ad; ebben a módban a Meshy figyelmen kívül hagyja a topology, target_polycount és should_remesh értékét. Részletes eredményhez válassza a 'standard' módot, vagy a 'smart-topology' módot a Meshy-T2 használatához a geometriai (preview) lépésben.
topologynem kötelező
Típusenum
Alapértelmezetttriangle
quadtriangle
Modelltopológia: Triangle a geometriai részletességhez, Quad a felületi simasághoz.
target_polycountnem kötelező
Típusinteger
Alapértelmezett30000
100 – 300 000
Poligonszám-cél, amelyet a 'smart-topology' model_type esetén 15,000-ben korlátoz. Ebben a módban a célérték kihagyása a Meshy alacsonyabb, 4,000-es alapértékét választja.
should_remeshnem kötelező
Típusboolean
Alapértelmezetttrue
A false értékkel kihagyja a remeshinget és nyers háromszöghálót kap; egyébként engedélyezi a remesh fázist.
symmetry_modenem kötelező
Típusenum
Alapértelmezettauto
offautoon
A modellgenerálás közben alkalmazott szimmetriabeállítás.
enable_pbrnem kötelező
Típusboolean
Alapértelmezettfalse
A fémességi, érdességi és normáltérképek generálását szabályozza az alapszín mellett.
is_a_t_posenem kötelező
Típusboolean
Alapértelmezettfalse
A true értékkel aktivált T-póz-generálás; a pose_mode váltja fel.
pose_modenem kötelező
Típusenum
Alapértelmezett
a-poset-pose
Hagyja üresen a karakter pózának megadásának mellőzéséhez, vagy kérjen A-pózt 'a-pose', illetve T-pózt 't-pose' értékkel.
enable_prompt_expansionnem kötelező
Típusboolean
Alapértelmezettfalse
Lehetővé teszi egy nagy nyelvi modell számára, hogy részletekkel gazdagítsa a promptot. Ennek a bővítésnek az engedélyezése nem változtatja meg a prompt jelentését.
texture_promptnem kötelező
Típusstring | null
≤ 600 karakter
Textúrázás irányítása további szöveges prompttal 'full' módban; más módok nem használják.
texture_image_urlnem kötelező
Típusurl · image
Textúrageneráláshoz használt 2D-referenciakép, csak 'full' módban.
enable_riggingnem kötelező
Típusboolean
Alapértelmezettfalse
Automatikus humanoid riggelés, amely a jól elkülöníthető végtagokkal rendelkező humanoid modelleknél a leghatékonyabb. Engedélyezése riggeli a generált modellt, és alapvető séta- és futóanimációkat biztosít.
rigging_height_metersnem kötelező
Típusnumber
Alapértelmezett1.7
> 0
Becsült karaktermagasság méterben, ha az enable_rigging true; egyébként nincs hatása.
enable_animationnem kötelező
Típusboolean
Alapértelmezettfalse
Azt jelzi, kap-e a riggelt modell előre beállított animációt; ehhez az enable_rigging értékének true-nak kell lennie.
animation_action_idnem kötelező
Típusinteger
Alapértelmezett92
Meshy-könyvtári animációs előbeállítás azonosítója; az elérhető műveletek a https://docs.meshy.ai/en/api/animation-library címen találhatók. Az ellenőrzés és használat csak akkor érvényes, ha az enable_animation true: a [0, 696] tartományon kívüli értékeket 422-es hibával elutasítja, az "Idle" pedig `0`.
enable_safety_checkernem kötelező
Típusboolean
Alapértelmezetttrue
Előfeldolgozási biztonsági ellenőrzés kapcsolója: a true érték a bemenet biztonsági ellenőrzését a feldolgozás előfeltételévé teszi.
kötelező

A fájlparaméterek nyilvános https:// URL-t, legfeljebb 10 MB-os data: URI-t vagy egy feltöltés file_url értékét fogadják el. Fájlok

Kimenet

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"
  }
}
Az Ön fájljai, az Ön döntéseMinden outputs[].url a tárhelyünkön lévő másolat: örökre megőrizve (GB-hónaponként fizetve) vagy 7 nap ideig ingyenesen, a fiókbeállításod vagy a ?storage= alapján.
Azonos struktúra minden modellentype, url, content_type, width, height és duration képekhez, videókhoz és hanganyagokhoz egyaránt. Az output a modell saját eredményobjektuma.
A kimenet mezői
animation_glb
object {url, content_type, file_name, file_size} | nullA 3D-modellt GLB-ként tartalmazó animációs eredmény; a válasz ezt csak akkor tartalmazza, ha az enable_animation true.
animation_fbx
object {url, content_type, file_name, file_size} | nullA 3D-modellt FBX-ként tartalmazó animációs eredmény; a válasz ezt csak akkor tartalmazza, ha az enable_animation true.
model_glb
object {url, content_type, file_name, file_size}A generált 3D-objektumot tartalmazó GLB-fájl.
thumbnail
object {url, content_type, file_name, file_size} | nullA generált modell előnézetét megjelenítő bélyegkép.
model_urls
object {glb, fbx, obj, usdz, blend, stl}A 3D-modellre mutató hivatkozások különböző formátumokban.
texture_urls
array of object {base_color, metallic, normal, roughness}Objektumtömbként reprezentált textúrafájlok.
seed
integer | nullA generálás során használt seedérték.
prompt
stringA generáláshoz megadott szöveges prompt.
actual_prompt
string | nullA generáláshoz ténylegesen alkalmazott promptszöveg, ha a promptbővítés engedélyezve volt.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullGLB-karakterfájlként átadott riggelési eredmény; csak akkor szerepel a válaszban, ha az enable_rigging true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullFBX-karakterfájlként átadott riggelési eredmény; csak akkor szerepel a válaszban, ha az enable_rigging true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAlapvető séta- és futóanimációk, csak akkor szerepelnek, ha az enable_rigging true.
rig_task_id
string | nullA riggelési feladat azonosítója; csak akkor szerepel, ha az enable_rigging true.

További modellek: Szövegből 3D

AI-ügynököknek: ez az oldal Markdown formátumban itt található: https://doitong.com/hu/developers/models/meshy/v6/text-to-3d.md. Minden modell és útmutató: https://doitong.com/developers/llms.txt