Neidio i'r cynnwys

Meshy V7 Text to 3D

Integreiddio

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

Ffeiliau fel yr enghraifft: $1.20 1,200 o gredydau API · ≈ ₽129.10 caiff eich ffeiliau eu mesur cyn y rhediad Ei redeg ar y dudalen hon

Cael allwedd API
Meshy Testun i 3D #stylized#transform

Testun-i-3D gyda Meshy 7: modd rhagolwg neu lawn, geometreg 2k, PBR, rigio ac animeiddio dewisol

Meshy · 3D

Mae eich canlyniad cyntaf yn mynd yma

Adeiladwch gais isod a'i redeg gyda'ch allwedd API. Mae allbynnau'n cael eu copïo i'n storio, wedi'u cadw am byth neu am 7 diwrnod am ddim.

Adeiladu cais

Cynhyrchir rheolyddion o sgema'r model. Mae'r cod a'r pris yn diweddaru wrth i chi eu newid.

•gofynnol 88 / 600

Disgrifiad o'r gwrthrych i'w gynrychioli fel model 3D, wedi'i gyfyngu i 600 nod.

mode rhagosodedig full

Modd cynhyrchu: mae 'preview' yn allbynnu geometreg heb weadau, tra bod 'full' yn allbynnu model â gweadau drwy gyfuno preview a refine.

geometry_resolution

Cydraniad geometreg y rhwyll; yr opsiynau Meshy-7 a gefnogir yw standard a 2k.

Uwch 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

Arwain texturing gyda sbardun testun ychwanegol yn y modd 'full'; nid yw moddau eraill yn ei ddefnyddio.

Gollyngwch ffeil, neu

Delwedd gyfeirio 2D ar gyfer cynhyrchu gweadau, a gymhwysir dim ond yn y modd 'full'.

model_type rhagosodedig standard

Modd rhwyll 3D: dewiswch 'lowpoly' ar gyfer canlyniad low-poly wedi'i optimeiddio ar gyfer polygonau glanach; yn y modd hwn mae Meshy yn anwybyddu topology, target_polycount, a should_remesh. Ar gyfer canlyniad confensiynol manwl iawn dewiswch 'standard', neu dewiswch 'smart-topology' i ddefnyddio Meshy-T2 yn ystod y cam geometreg (preview) a chael rhannau glân wedi'u cynhyrchu ar wahân o'r cychwyn.

topology rhagosodedig triangle

Dewis topology'r model rhwng Triangle ar gyfer manylion geometrig a Quad ar gyfer llyfnder yr arwyneb.

symmetry_mode rhagosodedig auto

Gosodiad cymesuredd a gymhwysir wrth gynhyrchu'r model.

pose_mode rhagosodedig

Gadewch y llinyn yn wag er mwyn peidio â nodi ystum y model a gynhyrchir, neu gofynnwch am ystum A gyda 'a-pose' neu ystum T gyda 't-pose'.

rhagosodedig 30000

Targed cyfrif polygonau, wedi'i gyfyngu i 15,000 pan fo model_type yn 'smart-topology'. Mae hepgor y targed yn y modd hwnnw yn dewis rhagosodiad is Meshy, sef 4,000.

rhagosodedig 1.7

Darparwch uchder cymeriad amcangyfrifedig mewn metrau pan fo enable_rigging yn true; fel arall, nid yw'r gwerth hwn yn cael unrhyw effaith.

rhagosodedig 92

ID rhagosodiad animeiddio llyfrgell Meshy, gyda'r gweithredoedd sydd ar gael wedi'u rhestru yn https://docs.meshy.ai/en/api/animation-library. Mae dilysu a defnyddio yn berthnasol dim ond pan fo enable_animation yn true: gwrthodir gwerthoedd y tu allan i [0, 696] gyda 422, ac mae "Idle" yn cyfateb i `0`.

Ailddefnyddiwch yr hadau hwn ynghyd ag anogiad digyfnewid i atgynhyrchu canlyniad cynharach fel arfer.

POST /run/meshy/v7/text-to-3d?wait=20 dyfynbris → $1.20
# 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/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Rhedeg y cais hwn

Mae'ch allwedd yn aros yn y porwr hwn: caiff ei hanfon at Doitong API yn unig a'i chadw (localStorage) dim ond os ticiwch Cofio. Cael allwedd API

Ynglŷn â Meshy V7 Text to 3D

Yn cynhyrchu model 3D o `prompt` o hyd at 600 nod, gyda `enable_prompt_expansion` dewisol. Mae `mode` yn dychwelyd naill ai geometreg heb weadau neu fodel gweadog. Dewiswch safonol, lowpoly neu smart-topology drwy `model_type`, gosodwch `target_polycount` o 100 i 300000, a dewiswch `geometry_resolution` safonol neu 2k. Gellir ychwanegu rhagosodiadau rigio ac animeiddio ar gyfer cymeriadau humanoid.

Paramedrau

EnwMath RhagosodedigCaniateir Disgrifiad
promptgofynnol
Mathstring
≤ 600 nod
Disgrifiad o'r gwrthrych i'w gynrychioli fel model 3D, wedi'i gyfyngu i 600 nod.
modedewisol
Mathenum
Rhagosodedigfull
previewfull
Modd cynhyrchu: mae 'preview' yn allbynnu geometreg heb weadau, tra bod 'full' yn allbynnu model â gweadau drwy gyfuno preview a refine.
seeddewisol
Mathinteger | null
Ailddefnyddiwch yr hadau hwn ynghyd ag anogiad digyfnewid i atgynhyrchu canlyniad cynharach fel arfer.
model_typedewisol
Mathenum
Rhagosodedigstandard
standardlowpolysmart-topology
Modd rhwyll 3D: dewiswch 'lowpoly' ar gyfer canlyniad low-poly wedi'i optimeiddio ar gyfer polygonau glanach; yn y modd hwn mae Meshy yn anwybyddu topology, target_polycount, a should_remesh. Ar gyfer canlyniad confensiynol manwl iawn dewiswch 'standard', neu dewiswch 'smart-topology' i ddefnyddio Meshy-T2 yn ystod y cam geometreg (preview) a chael rhannau glân wedi'u cynhyrchu ar wahân o'r cychwyn.
topologydewisol
Mathenum
Rhagosodedigtriangle
quadtriangle
Dewis topology'r model rhwng Triangle ar gyfer manylion geometrig a Quad ar gyfer llyfnder yr arwyneb.
target_polycountdewisol
Mathinteger
Rhagosodedig30000
100 – 300,000
Targed cyfrif polygonau, wedi'i gyfyngu i 15,000 pan fo model_type yn 'smart-topology'. Mae hepgor y targed yn y modd hwnnw yn dewis rhagosodiad is Meshy, sef 4,000.
should_remeshdewisol
Mathboolean
Rhagosodedigtrue
Hepgor ail-rwyllo a derbyn y rhwyll drionglog amrwd drwy osod hwn i false; fel arall, galluogwch y cam ail-rwyllo.
symmetry_modedewisol
Mathenum
Rhagosodedigauto
offautoon
Gosodiad cymesuredd a gymhwysir wrth gynhyrchu'r model.
enable_pbrdewisol
Mathboolean
Rhagosodedigfalse
Rheoli cynhyrchu mapiau PBR metelig, garwedd a normal ochr yn ochr â'r lliw sylfaenol.
is_a_t_posedewisol
Mathboolean
Rhagosodedigfalse
Switsh cynhyrchu ystum T a weithredir gan true; wedi'i anghymeradwyo o blaid pose_mode.
pose_modedewisol
Mathenum
Rhagosodedig
a-poset-pose
Gadewch y llinyn yn wag er mwyn peidio â nodi ystum y model a gynhyrchir, neu gofynnwch am ystum A gyda 'a-pose' neu ystum T gyda 't-pose'.
enable_prompt_expansiondewisol
Mathboolean
Rhagosodedigfalse
Caniatáu i fodel iaith mawr gyfoethogi'r anogiad â manylion. Nid yw galluogi'r ehangiad hwn yn newid ystyr yr anogiad.
texture_promptdewisol
Mathstring | null
≤ 600 nod
Arwain texturing gyda sbardun testun ychwanegol yn y modd 'full'; nid yw moddau eraill yn ei ddefnyddio.
texture_image_urldewisol
Mathurl · image
Delwedd gyfeirio 2D ar gyfer cynhyrchu gweadau, a gymhwysir dim ond yn y modd 'full'.
enable_riggingdewisol
Mathboolean
Rhagosodedigfalse
Rigio humanoid awtomatig, sydd fwyaf effeithiol ar gyfer modelau humanoid y gellir gwahaniaethu'n glir rhwng eu coesau. Mae ei alluogi'n rigio'r model a gynhyrchir ac yn darparu animeiddiadau sylfaenol ar gyfer cerdded a rhedeg.
rigging_height_metersdewisol
Mathnumber
Rhagosodedig1.7
> 0
Darparwch uchder cymeriad amcangyfrifedig mewn metrau pan fo enable_rigging yn true; fel arall, nid yw'r gwerth hwn yn cael unrhyw effaith.
enable_animationdewisol
Mathboolean
Rhagosodedigfalse
A yw'r model wedi'i rigio yn cael animeiddiad rhagosodedig, sy'n gofyn i enable_rigging fod yn true.
animation_action_iddewisol
Mathinteger
Rhagosodedig92
ID rhagosodiad animeiddio llyfrgell Meshy, gyda'r gweithredoedd sydd ar gael wedi'u rhestru yn https://docs.meshy.ai/en/api/animation-library. Mae dilysu a defnyddio yn berthnasol dim ond pan fo enable_animation yn true: gwrthodir gwerthoedd y tu allan i [0, 696] gyda 422, ac mae "Idle" yn cyfateb i `0`.
enable_safety_checkerdewisol
Mathboolean
Rhagosodedigtrue
Switsh gwiriad diogelwch rhagbrosesu: mae true yn gwneud gwiriad diogelwch mewnbwn yn rhagofyniad i brosesu.
geometry_resolutiondewisol
Mathenum
standard2k
Cydraniad geometreg y rhwyll; yr opsiynau Meshy-7 a gefnogir yw standard a 2k.
ultra_modedewisol
Mathboolean
Rhagosodedigfalse
Opsiwn anghymeradwy a ddisodlwyd gan geometry_resolution, sy'n ennill os darperir y ddau; defnyddiwch geometry_resolution='2k' yn lle hynny.
gofynnol

Mae paramedrau ffeil yn derbyn URL cyhoeddus https://, URI data: hyd at 10 MB, neu file_url uwchlwythiad. Ffeiliau

Allbwn

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Eich ffeiliau, eich dewisMae pob outputs[].url yn gopi ar ein storio: wedi'i gadw am byth (telir fesul GB-mis) neu am 7 diwrnod am ddim, yn ôl gosodiad eich cyfrif neu ?storage=.
Yr un siâp ar bob modeltype, url, content_type, width, height a duration, ar gyfer delweddau, fideo a sain fel ei gilydd. Gwrthrych canlyniad y model ei hun yw output.
Meysydd yr allbwn
animation_glb
object {url, content_type, file_name, file_size} | nullCanlyniad animeiddio sy'n cynnwys y model 3D fel GLB; mae'r ymateb yn hepgor y canlyniad hwn oni bai bod enable_animation yn true.
animation_fbx
object {url, content_type, file_name, file_size} | nullCanlyniad animeiddio sy'n cynnwys y model 3D fel FBX; mae'r ymateb yn hepgor y canlyniad hwn oni bai bod enable_animation yn true.
model_glb
object {url, content_type, file_name, file_size}Ffeil GLB sy'n cynnwys y gwrthrych 3D a gynhyrchir.
thumbnail
object {url, content_type, file_name, file_size} | nullMân-lun sy'n dangos rhagolwg o'r model a gynhyrchir.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Dolenni i'r model 3D mewn fformatau amrywiol.
texture_urls
array of object {base_color, metallic, normal, roughness}Ffeiliau gwead a gynrychiolir fel arae o wrthrychau.
seed
integer | nullGwerth hadau a ddefnyddir yn ystod cynhyrchu.
prompt
stringAnogiad testun a ddarparwyd ar gyfer cynhyrchu.
actual_prompt
string | nullAnogiad a gymhwyswyd mewn gwirionedd i'r cynhyrchu pan oedd ehangu anogiad wedi'i alluogi.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullCanlyniad rigio a ddarperir fel ffeil cymeriad GLB; yn absennol o'r ymateb oni bai bod enable_rigging yn true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullCanlyniad rigio a ddarperir fel ffeil cymeriad FBX; yn absennol o'r ymateb oni bai bod enable_rigging yn true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullAnimeiddiadau cerdded a rhedeg sylfaenol, wedi'u cynnwys dim ond os yw enable_rigging yn true.
rig_task_id
string | nullDynodwr ar gyfer y dasg rigio; wedi'i gynnwys dim ond os yw enable_rigging yn true.

Mwy o fodelau: Testun i 3D

Ar gyfer asiantau AI: mae'r dudalen hon fel Markdown ar gael yn https://doitong.com/cy/developers/models/meshy/v7/text-to-3d.md. Pob model a chanllaw: https://doitong.com/developers/llms.txt