Přejít na obsah

Meshy 6 · Text to 3D

Integrace

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

Tento požadavek: 0,80 $ 800 kreditů API Spustit na této stránce

Získat API klíč
Meshy Text na 3D #text-to-3d

Generátor 3D sítí z textu s režimem náhledu nebo texturování, volitelným PBR, rigem a animací

Meshy · 3D

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné 88 / 600

Popis objektu, který má být reprezentován jako 3D model, omezený na 600 znaků.

Pokročilé 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

Řízení texturování dodatečným textovým promptem v režimu 'full'; ostatní režimy jej nepoužívají.

Přetáhněte soubor nebo

2D referenční obrázek pro generování textur použitý pouze v režimu 'full'.

mode výchozí full

Režim generování: 'preview' vytváří geometrii bez textur, zatímco 'full' vytváří texturovaný model kombinací preview a refine.

model_type výchozí standard

Režim 3D meshe: zvolte 'lowpoly' pro low-poly výsledek optimalizovaný pro čistší polygony; v tomto režimu Meshy ignoruje topology, target_polycount a should_remesh. Pro běžný detailní výsledek zvolte 'standard' nebo 'smart-topology' pro použití Meshy-T2 během kroku geometrie (preview) a získání čistých částí generovaných odděleně od začátku.

topology výchozí triangle

Volba topologie modelu mezi Triangle pro geometrické detaily a Quad pro hladkost povrchu.

symmetry_mode výchozí auto

Nastavení symetrie použité při generování modelu.

pose_mode výchozí

Ponechte řetězec prázdný, pokud nechcete určit pózu vygenerovaného modelu, nebo vyžádejte A-pózu pomocí 'a-pose' či T-pózu pomocí 't-pose'.

výchozí 30000

Cílový počet polygonů, omezený na 15,000, když model_type je 'smart-topology'. Při vynechání cíle v tomto režimu se použije nižší výchozí hodnota Meshy 4,000.

výchozí 1.7

Pokud je enable_rigging true, zadejte odhadovanou výšku postavy v metrech; jinak tato hodnota nemá žádný účinek.

výchozí 92

ID přednastavené animace z knihovny Meshy; dostupné akce jsou uvedeny na https://docs.meshy.ai/en/api/animation-library. Ověření a použití se provádí pouze, když je enable_animation true: hodnoty mimo [0, 696] jsou odmítnuty s chybou 422 a "Idle" odpovídá `0`.

Znovu použijte tento seed s nezměněným promptem, abyste obvykle zopakovali dřívější výsledek.

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

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Meshy 6 · Text to 3D

Vytváří 3D model z textového `prompt` o délce až 600 znaků. `mode` volí netexturovanou geometrii (`preview`) nebo texturovaný výsledek (`full`). `model_type` může být standard, lowpoly nebo smart-topology a `target_polycount` má rozsah 100 až 300000; u smart topology je limit 15000. Lze také přidat PBR mapy, pózu, humanoidní rig a předvolbu animace.

Parametry

NázevTyp VýchozíPovolené Popis
promptpovinné
Typstring
≤ 600 znaků
Popis objektu, který má být reprezentován jako 3D model, omezený na 600 znaků.
modevolitelné
Typenum
Výchozífull
previewfull
Režim generování: 'preview' vytváří geometrii bez textur, zatímco 'full' vytváří texturovaný model kombinací preview a refine.
seedvolitelné
Typinteger | null
Znovu použijte tento seed s nezměněným promptem, abyste obvykle zopakovali dřívější výsledek.
model_typevolitelné
Typenum
Výchozístandard
standardlowpolysmart-topology
Režim 3D meshe: zvolte 'lowpoly' pro low-poly výsledek optimalizovaný pro čistší polygony; v tomto režimu Meshy ignoruje topology, target_polycount a should_remesh. Pro běžný detailní výsledek zvolte 'standard' nebo 'smart-topology' pro použití Meshy-T2 během kroku geometrie (preview) a získání čistých částí generovaných odděleně od začátku.
topologyvolitelné
Typenum
Výchozítriangle
quadtriangle
Volba topologie modelu mezi Triangle pro geometrické detaily a Quad pro hladkost povrchu.
target_polycountvolitelné
Typinteger
Výchozí30000
100 – 300 000
Cílový počet polygonů, omezený na 15,000, když model_type je 'smart-topology'. Při vynechání cíle v tomto režimu se použije nižší výchozí hodnota Meshy 4,000.
should_remeshvolitelné
Typboolean
Výchozítrue
Nastavením na false přeskočíte remeshing a obdržíte surový trojúhelníkový mesh; jinak povolte fázi remeshingu.
symmetry_modevolitelné
Typenum
Výchozíauto
offautoon
Nastavení symetrie použité při generování modelu.
enable_pbrvolitelné
Typboolean
Výchozífalse
Určuje generování kovové, roughness a normálové PBR mapy spolu se základní barvou.
is_a_t_posevolitelné
Typboolean
Výchozífalse
Přepínač generování v T-póze aktivovaný hodnotou true; zastaralý ve prospěch pose_mode.
pose_modevolitelné
Typenum
Výchozí
a-poset-pose
Ponechte řetězec prázdný, pokud nechcete určit pózu vygenerovaného modelu, nebo vyžádejte A-pózu pomocí 'a-pose' či T-pózu pomocí 't-pose'.
enable_prompt_expansionvolitelné
Typboolean
Výchozífalse
Povolí velkému jazykovému modelu obohatit prompt o podrobnosti. Toto rozšíření nemění význam promptu.
texture_promptvolitelné
Typstring | null
≤ 600 znaků
Řízení texturování dodatečným textovým promptem v režimu 'full'; ostatní režimy jej nepoužívají.
texture_image_urlvolitelné
Typurl · image
2D referenční obrázek pro generování textur použitý pouze v režimu 'full'.
enable_riggingvolitelné
Typboolean
Výchozífalse
Automatický rigging humanoidní postavy, nejúčinnější u humanoidních modelů s jasně rozlišitelnými končetinami. Jeho povolením se vygenerovaný model zriguje a dodají se základní animace chůze a běhu.
rigging_height_metersvolitelné
Typnumber
Výchozí1.7
> 0
Pokud je enable_rigging true, zadejte odhadovanou výšku postavy v metrech; jinak tato hodnota nemá žádný účinek.
enable_animationvolitelné
Typboolean
Výchozífalse
Určuje, zda rigovaný model obdrží přednastavenou animaci, což vyžaduje enable_rigging true.
animation_action_idvolitelné
Typinteger
Výchozí92
ID přednastavené animace z knihovny Meshy; dostupné akce jsou uvedeny na https://docs.meshy.ai/en/api/animation-library. Ověření a použití se provádí pouze, když je enable_animation true: hodnoty mimo [0, 696] jsou odmítnuty s chybou 422 a "Idle" odpovídá `0`.
enable_safety_checkervolitelné
Typboolean
Výchozítrue
Přepínač bezpečnostní kontroly před zpracováním: true znamená, že bezpečnostní kontrola vstupu je podmínkou zpracování.
povinné

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
animation_glb
object {url, content_type, file_name, file_size} | nullVýsledek animace obsahující 3D model ve formátu GLB; odpověď tento výsledek vynechá, pokud enable_animation není true.
animation_fbx
object {url, content_type, file_name, file_size} | nullVýsledek animace obsahující 3D model ve formátu FBX; odpověď tento výsledek vynechá, pokud enable_animation není true.
model_glb
object {url, content_type, file_name, file_size}Soubor GLB obsahující vygenerovaný 3D objekt.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatura s náhledem vygenerovaného modelu.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Odkazy na 3D model v různých formátech.
texture_urls
array of object {base_color, metallic, normal, roughness}Soubory textur reprezentované jako pole objektů.
seed
integer | nullHodnota seedu použitá během generování.
prompt
stringTextový prompt zadaný pro generování.
actual_prompt
string | nullPrompt skutečně použitý při generování, když bylo povoleno rozšíření promptu.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullVýsledek riggingu dodaný jako soubor postavy GLB; v odpovědi chybí, pokud enable_rigging není true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullVýsledek riggingu dodaný jako soubor postavy FBX; v odpovědi chybí, pokud enable_rigging není true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullZákladní animace chůze a běhu zahrnuté pouze při enable_rigging true.
rig_task_id
string | nullIdentifikátor úlohy riggingu zahrnutý pouze při enable_rigging true.

Další modely: Text na 3D

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/meshy/v6/text-to-3d.md. Všechny modely a návody: https://doitong.com/developers/llms.txt