Léim chuig an ábhar

Meshy 6 · Text to 3D

Comhtháthú

Aitheantas na samhla 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"

An t-iarratas seo: $0.80 800 gcreidmheas API · ≈ ₽86.06 Rith ar an leathanach seo

Faigh eochair API
Meshy Téacs go 3D #text-to-3d

Gineadóir mogall téacs-go-3D le modhanna réamhamhairc nó uigeachta, PBR, rigáil agus beochan roghnacha

Meshy · 3D

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

•riachtanach 88 / 600

Cur síos ar an réad atá le léiriú mar shamhail 3D, teoranta do 600 carachtar.

Ardleibhéal 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

Treoraigh uigeacht le leid téacs bhreise sa mhód 'full'; ní úsáideann na móid eile í.

Scaoil comhad, nó

Íomhá thagartha 2D do ghiniúint uigeachta, curtha i bhfeidhm sa mhód 'full' amháin.

mode réamhshocrú full

Mód giniúna: aschuir 'preview' céimseata gan uigeachtaí, agus aschuir 'full' samhail uigeach trí preview agus refine a chomhcheangal.

model_type réamhshocrú standard

Mód mogall 3D: roghnaigh 'lowpoly' le haghaidh aschur íseal-pholagán optamaithe do pholagáin níos glaine; sa mhód seo déanann Meshy neamhaird de topology, target_polycount agus should_remesh. Le haghaidh gnáth-aschur ardsonraí roghnaigh 'standard', nó 'smart-topology' chun Meshy-T2 a úsáid le linn na céime céimseata (preview) agus páirteanna glana a ghiniúint ar leith ón tús.

topology réamhshocrú triangle

Rogha topology na samhla idir Triangle le haghaidh sonraí geoiméadracha agus Quad le haghaidh réidhe dromchla.

symmetry_mode réamhshocrú auto

Socrú siméadrachta a chuirtear i bhfeidhm agus an tsamhail á giniúint.

pose_mode réamhshocrú

Fág an teaghrán folamh chun staidiúir na samhla ginte a fhágáil gan sonrú, nó iarr A-pose le 'a-pose' nó T-pose le 't-pose'.

réamhshocrú 30000

Sprioc líon na bpolagán, teoranta do 15,000 nuair atá model_type 'smart-topology'. Mura sonraítear an sprioc sa mhód sin, roghnaítear réamhshocrú níos ísle Meshy de 4,000.

réamhshocrú 1.7

Soláthair airde mheasta an charachtair i méadar nuair atá enable_rigging fíor; murach sin, níl aon éifeacht ag an luach seo.

réamhshocrú 92

Aitheantas réamhshocraithe beochana leabharlann Meshy, agus na gníomhartha atá ar fáil liostaithe ag https://docs.meshy.ai/en/api/animation-library. Ní bhaineann bailíochtú agus úsáid leis ach nuair atá enable_animation fíor: diúltaítear do luachanna lasmuigh de [0, 696] le 422, agus comhfhreagraíonn "Idle" do `0`.

Athúsáid an síol seo le leid gan athrú chun toradh níos luaithe a atáirgeadh de ghnáth.

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

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le Meshy 6 · Text to 3D

Tógann sé samhail 3D ó `prompt` téacs suas le 600 carachtar. Roghnaíonn `mode` geometeracht gan uigeacht (`preview`) nó toradh le huigeacht (`full`). Is féidir `model_type` a bheith standard, lowpoly nó smart-topology, agus raonta `target_polycount` ó 100 go 300000, le smart topology teoranta do 15000. Is féidir mapaí PBR, staidiúir, rigáil daonnóideach agus réamhshocrú beochana a chur leis freisin.

Paraiméadair

AinmCineál RéamhshocrúCeadaithe Cur síos
promptriachtanach
Cineálstring
≤ 600 gcarachtar
Cur síos ar an réad atá le léiriú mar shamhail 3D, teoranta do 600 carachtar.
moderoghnach
Cineálenum
Réamhshocrúfull
previewfull
Mód giniúna: aschuir 'preview' céimseata gan uigeachtaí, agus aschuir 'full' samhail uigeach trí preview agus refine a chomhcheangal.
seedroghnach
Cineálinteger | null
Athúsáid an síol seo le leid gan athrú chun toradh níos luaithe a atáirgeadh de ghnáth.
model_typeroghnach
Cineálenum
Réamhshocrústandard
standardlowpolysmart-topology
Mód mogall 3D: roghnaigh 'lowpoly' le haghaidh aschur íseal-pholagán optamaithe do pholagáin níos glaine; sa mhód seo déanann Meshy neamhaird de topology, target_polycount agus should_remesh. Le haghaidh gnáth-aschur ardsonraí roghnaigh 'standard', nó 'smart-topology' chun Meshy-T2 a úsáid le linn na céime céimseata (preview) agus páirteanna glana a ghiniúint ar leith ón tús.
topologyroghnach
Cineálenum
Réamhshocrútriangle
quadtriangle
Rogha topology na samhla idir Triangle le haghaidh sonraí geoiméadracha agus Quad le haghaidh réidhe dromchla.
target_polycountroghnach
Cineálinteger
Réamhshocrú30000
100 – 300,000
Sprioc líon na bpolagán, teoranta do 15,000 nuair atá model_type 'smart-topology'. Mura sonraítear an sprioc sa mhód sin, roghnaítear réamhshocrú níos ísle Meshy de 4,000.
should_remeshroghnach
Cineálboolean
Réamhshocrútrue
Scipeáil athmhogalú agus faigh an mogall triantánach amh trí false a shocrú; murach sin, cumasaigh céim an athmhogalaithe.
symmetry_moderoghnach
Cineálenum
Réamhshocrúauto
offautoon
Socrú siméadrachta a chuirtear i bhfeidhm agus an tsamhail á giniúint.
enable_pbrroghnach
Cineálboolean
Réamhshocrúfalse
Rialaíonn sé giniúint léarscáileanna PBR miotalachta, garbhachta agus normálta taobh leis an mbundath.
is_a_t_poseroghnach
Cineálboolean
Réamhshocrúfalse
Lascthrealamh giniúna T-pose a ghníomhaíonn true; tá sé as feidhm i bhfabhar pose_mode.
pose_moderoghnach
Cineálenum
Réamhshocrú
a-poset-pose
Fág an teaghrán folamh chun staidiúir na samhla ginte a fhágáil gan sonrú, nó iarr A-pose le 'a-pose' nó T-pose le 't-pose'.
enable_prompt_expansionroghnach
Cineálboolean
Réamhshocrúfalse
Lig do mhúnla mór teanga an leid a shaibhriú le sonraí. Ní athraíonn cumasú an leathnaithe brí na leide.
texture_promptroghnach
Cineálstring | null
≤ 600 gcarachtar
Treoraigh uigeacht le leid téacs bhreise sa mhód 'full'; ní úsáideann na móid eile í.
texture_image_urlroghnach
Cineálurl · image
Íomhá thagartha 2D do ghiniúint uigeachta, curtha i bhfeidhm sa mhód 'full' amháin.
enable_riggingroghnach
Cineálboolean
Réamhshocrúfalse
Rigáil uathoibríoch dhaonna, is éifeachtaí do shamhlacha daonna a bhfuil a ngéaga in-idirdhealaithe go soiléir. Trí í a chumasú, rigáiltear an tsamhail ginte agus soláthraítear beochana bunúsacha siúil agus reatha.
rigging_height_metersroghnach
Cineálnumber
Réamhshocrú1.7
> 0
Soláthair airde mheasta an charachtair i méadar nuair atá enable_rigging fíor; murach sin, níl aon éifeacht ag an luach seo.
enable_animationroghnach
Cineálboolean
Réamhshocrúfalse
An bhfaigheann an tsamhail rigáilte beochan réamhshocraithe, rud a éilíonn go mbeadh enable_rigging fíor.
animation_action_idroghnach
Cineálinteger
Réamhshocrú92
Aitheantas réamhshocraithe beochana leabharlann Meshy, agus na gníomhartha atá ar fáil liostaithe ag https://docs.meshy.ai/en/api/animation-library. Ní bhaineann bailíochtú agus úsáid leis ach nuair atá enable_animation fíor: diúltaítear do luachanna lasmuigh de [0, 696] le 422, agus comhfhreagraíonn "Idle" do `0`.
enable_safety_checkerroghnach
Cineálboolean
Réamhshocrútrue
Lascthrealamh seiceála sábháilteachta réamhphróiseála: déanann true seiceáil sábháilteachta ionchuir réamhriachtanach don phróiseáil.
riachtanach

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

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"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
animation_glb
object {url, content_type, file_name, file_size} | nullToradh beochana ina bhfuil an tsamhail 3D mar GLB; fágann an freagra an toradh seo ar lár mura bhfuil enable_animation fíor.
animation_fbx
object {url, content_type, file_name, file_size} | nullToradh beochana ina bhfuil an tsamhail 3D mar FBX; fágann an freagra an toradh seo ar lár mura bhfuil enable_animation fíor.
model_glb
object {url, content_type, file_name, file_size}Comhad GLB ina bhfuil an réad 3D ginte.
thumbnail
object {url, content_type, file_name, file_size} | nullMionsamhail a thaispeánann réamhamharc den tsamhail ginte.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Naisc chuig an tsamhail 3D i bhformáidí éagsúla.
texture_urls
array of object {base_color, metallic, normal, roughness}Comhaid uigeachta léirithe mar eagar réad.
seed
integer | nullLuach síl a úsáidtear le linn na giniúna.
prompt
stringLeid téacs a soláthraíodh don ghiniúint.
actual_prompt
string | nullLeid a cuireadh i bhfeidhm i ndáiríre ar an nginiúint nuair a bhí leathnú leide cumasaithe.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullToradh rigála seachadta mar chomhad carachtair GLB; níl sé sa fhreagra mura bhfuil enable_rigging fíor.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullToradh rigála seachadta mar chomhad carachtair FBX; níl sé sa fhreagra mura bhfuil enable_rigging fíor.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullBeochana bunúsacha siúil agus reatha, san áireamh ach amháin má tá enable_rigging fíor.
rig_task_id
string | nullAitheantóir don tasc rigála; san áireamh ach amháin má tá enable_rigging fíor.

Tuilleadh samhlacha: Téacs go 3D

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/meshy/v6/text-to-3d.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt