Pereiti prie turinio

Meshy V7 Text to 3D

Integruoti

Modelio id 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"

Failai kaip pavyzdyje: 1,20 $ 1 200 API kreditų jūsų failai išmatuojami prieš paleidimą Paleisti šiame puslapyje

Gauti API raktą
Meshy Tekstas į 3D #stylized#transform

Teksto vertimas į 3D naudojant Meshy 7: peržiūros arba visas režimas, 2k geometrija, PBR, skeletavimo ir animacijos parinktys

Meshy · 3D

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma 88 / 600

Objekto, kuris bus pavaizduotas kaip 3D modelis, aprašymas, apribotas 600 simbolių.

mode numatytoji full

Generavimo režimas: 'preview' pateikia geometriją be tekstūrų, o 'full' pateikia tekstūruotą modelį, sujungdamas preview ir refine.

geometry_resolution

Tinklelio geometrijos raiška; palaikomos Meshy-7 parinktys yra standard ir 2k.

Išplėstiniai 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

Režimu 'full' tekstūravimą papildo tekstinis raginys; kiti režimai jo nenaudoja.

Įmeskite failą arba

2D atraminis vaizdas tekstūrų generavimui, taikomas tik režimu 'full'.

model_type numatytoji standard

3D tinklelio režimas: pasirinkite 'lowpoly', jei reikia mažo poligonų skaičiaus rezultato, optimizuoto tvarkingesniems poligonams; šiame režime Meshy nepaiso topology, target_polycount ir should_remesh. Įprastam detaliam rezultatui pasirinkite 'standard', o 'smart-topology' – jei norite naudoti Meshy-T2 geometrijos (preview) etape ir nuo pradžių gauti atskirai sugeneruotas tvarkingas dalis.

topology numatytoji triangle

Modelio topologijos pasirinkimas: Triangle suteikia geometrinių detalių, o Quad – paviršiaus glotnumo.

symmetry_mode numatytoji auto

Generuojant modelį taikomas simetrijos nustatymas.

pose_mode numatytoji

Palikite eilutę tuščią, jei nenorite nurodyti sugeneruoto modelio pozos, arba prašykite A pozos naudodami 'a-pose', o T pozos – 't-pose'.

numatytoji 30000

Tikslinis poligonų skaičius, apribotas iki 15,000, kai model_type yra 'smart-topology'. Šiame režime nenurodžius tikslo pasirenkamas mažesnis Meshy numatytasis dydis – 4,000.

numatytoji 1.7

Pateikite numatomą veikėjo ūgį metrais, kai enable_rigging yra true; kitu atveju ši reikšmė neturi poveikio.

numatytoji 92

Meshy bibliotekos animacijos išankstinio nustatymo ID; galimi veiksmai pateikti adresu https://docs.meshy.ai/en/api/animation-library. Tikrinimas ir naudojimas taikomi tik kai enable_animation yra true: reikšmės už [0, 696] ribų atmetamos su 422, o "Idle" atitinka `0`.

Pakartotinai naudokite šią pradžią su nepakitusiu raginį, kad paprastai atkurtumėte ankstesnį rezultatą.

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Meshy V7 Text to 3D

Generuoja 3D modelį iš iki 600 simbolių `prompt`, pasirinktinai naudojant `enable_prompt_expansion`. `mode` grąžina netekstūruotą geometriją arba tekstūruotą modelį. Naudodami `model_type` pasirinkite standard, lowpoly arba smart-topology, nustatykite `target_polycount` nuo 100 iki 300000 ir pasirinkite standard arba 2k `geometry_resolution`. Humanoidiniams personažams galima pridėti skeletavimą ir animacijos išankstinius nustatymus.

Parametrai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
promptprivaloma
Tipasstring
≤ 600 simbolių
Objekto, kuris bus pavaizduotas kaip 3D modelis, aprašymas, apribotas 600 simbolių.
modeneprivalomas
Tipasenum
Numatytoji reikšmėfull
previewfull
Generavimo režimas: 'preview' pateikia geometriją be tekstūrų, o 'full' pateikia tekstūruotą modelį, sujungdamas preview ir refine.
seedneprivalomas
Tipasinteger | null
Pakartotinai naudokite šią pradžią su nepakitusiu raginį, kad paprastai atkurtumėte ankstesnį rezultatą.
model_typeneprivalomas
Tipasenum
Numatytoji reikšmėstandard
standardlowpolysmart-topology
3D tinklelio režimas: pasirinkite 'lowpoly', jei reikia mažo poligonų skaičiaus rezultato, optimizuoto tvarkingesniems poligonams; šiame režime Meshy nepaiso topology, target_polycount ir should_remesh. Įprastam detaliam rezultatui pasirinkite 'standard', o 'smart-topology' – jei norite naudoti Meshy-T2 geometrijos (preview) etape ir nuo pradžių gauti atskirai sugeneruotas tvarkingas dalis.
topologyneprivalomas
Tipasenum
Numatytoji reikšmėtriangle
quadtriangle
Modelio topologijos pasirinkimas: Triangle suteikia geometrinių detalių, o Quad – paviršiaus glotnumo.
target_polycountneprivalomas
Tipasinteger
Numatytoji reikšmė30000
100 – 300 000
Tikslinis poligonų skaičius, apribotas iki 15,000, kai model_type yra 'smart-topology'. Šiame režime nenurodžius tikslo pasirenkamas mažesnis Meshy numatytasis dydis – 4,000.
should_remeshneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Nustatykite false, kad praleistumėte pakartotinį tinklelio kūrimą ir gautumėte neapdorotą trikampį tinklelį; kitu atveju įjunkite šį etapą.
symmetry_modeneprivalomas
Tipasenum
Numatytoji reikšmėauto
offautoon
Generuojant modelį taikomas simetrijos nustatymas.
enable_pbrneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Nurodo, ar kartu su pagrindine spalva generuojami metalinio blizgesio, šiurkštumo ir normalės PBR žemėlapiai.
is_a_t_poseneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
T pozos generavimo jungiklis, įjungiamas true; pasenęs ir pakeistas pose_mode.
pose_modeneprivalomas
Tipasenum
Numatytoji reikšmė
a-poset-pose
Palikite eilutę tuščią, jei nenorite nurodyti sugeneruoto modelio pozos, arba prašykite A pozos naudodami 'a-pose', o T pozos – 't-pose'.
enable_prompt_expansionneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Leidžia dideliam kalbos modeliui papildyti raginį detalėmis. Įjungus šį išplėtimą raginio reikšmė nesikeičia.
texture_promptneprivalomas
Tipasstring | null
≤ 600 simbolių
Režimu 'full' tekstūravimą papildo tekstinis raginys; kiti režimai jo nenaudoja.
texture_image_urlneprivalomas
Tipasurl · image
2D atraminis vaizdas tekstūrų generavimui, taikomas tik režimu 'full'.
enable_riggingneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Automatinis humanoidų rigging, veiksmingiausias humanoidiniams modeliams su aiškiai atskiriamomis galūnėmis. Jį įjungus sugeneruotam modeliui pritaikomas rigging ir pateikiamos pagrindinės ėjimo bei bėgimo animacijos.
rigging_height_metersneprivalomas
Tipasnumber
Numatytoji reikšmė1.7
> 0
Pateikite numatomą veikėjo ūgį metrais, kai enable_rigging yra true; kitu atveju ši reikšmė neturi poveikio.
enable_animationneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Nurodo, ar animuotam modeliui suteikiama išankstinė animacija; tam enable_rigging turi būti true.
animation_action_idneprivalomas
Tipasinteger
Numatytoji reikšmė92
Meshy bibliotekos animacijos išankstinio nustatymo ID; galimi veiksmai pateikti adresu https://docs.meshy.ai/en/api/animation-library. Tikrinimas ir naudojimas taikomi tik kai enable_animation yra true: reikšmės už [0, 696] ribų atmetamos su 422, o "Idle" atitinka `0`.
enable_safety_checkerneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Išankstinio saugos tikrinimo jungiklis: true reiškia, kad prieš apdorojimą būtina patikrinti įvesties saugą.
geometry_resolutionneprivalomas
Tipasenum
standard2k
Tinklelio geometrijos raiška; palaikomos Meshy-7 parinktys yra standard ir 2k.
ultra_modeneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Pasenusi parinktis, pakeista geometry_resolution; jei pateiktos abi, pirmenybė teikiama geometry_resolution. Naudokite geometry_resolution='2k'.
privaloma

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
animation_glb
object {url, content_type, file_name, file_size} | nullAnimacijos rezultatas su 3D modeliu GLB formatu; atsakyme jis nepateikiamas, jei enable_animation nėra true.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimacijos rezultatas su 3D modeliu FBX formatu; atsakyme jis nepateikiamas, jei enable_animation nėra true.
model_glb
object {url, content_type, file_name, file_size}GLB failas su sugeneruotu 3D objektu.
thumbnail
object {url, content_type, file_name, file_size} | nullMiniatiūra, kurioje rodoma sugeneruoto modelio peržiūra.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Nuorodos į įvairių formatų 3D modelį.
texture_urls
array of object {base_color, metallic, normal, roughness}Tekstūrų failai, pateikiami kaip objektų masyvas.
seed
integer | nullGeneruojant naudojama pradinė reikšmė.
prompt
stringGeneravimui pateiktas tekstinis raginys.
actual_prompt
string | nullGeneravimui faktiškai taikytas raginys, kai buvo įjungtas raginio išplėtimas.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullRigging rezultatas, pateikiamas kaip GLB veikėjo failas; atsakyme jo nėra, jei enable_rigging nėra true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullRigging rezultatas, pateikiamas kaip FBX veikėjo failas; atsakyme jo nėra, jei enable_rigging nėra true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullPagrindinės ėjimo ir bėgimo animacijos, įtraukiamos tik kai enable_rigging yra true.
rig_task_id
string | nullRigging užduoties identifikatorius; įtraukiamas tik kai enable_rigging yra true.

Daugiau modelių: Tekstas į 3D

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/meshy/v7/text-to-3d.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt