Léim chuig an ábhar

Meshy 7.1 Image to 3D

Comhtháthú

Aitheantas na samhla meshy/v7.1/image-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.1/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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"

Comhaid cosúil leis an sampla: $1.20 1,200 gcreidmheas API · ≈ ₽129.10 déantar do chuid comhad a thomhas roimh an rith Rith ar an leathanach seo

Faigh eochair API
Meshy Íomhá go 3D Aschur 4K #3d#image-to-3d#textures#pbr

Giniúint 3D ó íomhá aonair a chuireann rogha taifeach geoiméadrach 4k leis

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 image_url
Scaoil comhad, nó

Soláthair an íomhá foinse do chruthú 3D trí URL nó URI sonraí base64, ag úsáid .jpg, .jpeg, .png, AVIF nó HEIF. Láimhseálann tiontú uathoibríoch na hionchuir AVIF agus HEIF.

Ardleibhéal texture_prompt · texture_image_url · model_type · topology · symmetry_mode · pose_mode · geometry_resolution · target_polycount · rigging_height_meters · animation_action_id · should_remesh · enable_pbr · is_a_t_pose · enable_safety_checker · ultra_mode
0 / 600

Treoracha téacs a stiúrann giniúint uigeachta.

Scaoil comhad, nó

Íomhá thagartha 2D a stiúrann giniúint uigeachta.

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ó roghnaigh 'smart-topology' chun Meshy-T2 a úsáid 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

Roghnaigh an gcuireann giniúint na samhla siméadracht i bhfeidhm le On, an bhfágann sí ar lár í le Off, nó an gcinneann sí go huathoibríoch le Auto.

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'.

geometry_resolution

Taifeach na céimseata; éilíonn 4k Meshy-7.1.

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`.

POST /run/meshy/v7.1/image-to-3d?wait=20 luachan → $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.1/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 7.1 Image to 3D

Déanann sé samhail 3D ó íomhá amháin in `image_url`. Glacann `geometry_resolution` standard, 2k nó 4k, agus níl 4k ar fáil ach sa leagan seo. Clúdaíonn `model_type` standard, lowpoly agus smart-topology, agus ritheann `target_polycount` ó 100 go 300000. Tá uigeachtaí, mapaí PBR, mód staide, rigáil daonnóideach agus réamhshocruithe beochana roghnach.

Paraiméadair

Seol an t-ainm canónach nó an t-ainm dúchasach, ní an dá cheann. Ainmneacha canónacha

AinmCineál RéamhshocrúCeadaithe Cur síos
image_urlriachtanach image
Cineálurl · image
Soláthair an íomhá foinse do chruthú 3D trí URL nó URI sonraí base64, ag úsáid .jpg, .jpeg, .png, AVIF nó HEIF. Láimhseálann tiontú uathoibríoch na hionchuir AVIF agus HEIF.
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ó roghnaigh 'smart-topology' chun Meshy-T2 a úsáid 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.
symmetry_moderoghnach
Cineálenum
Réamhshocrúauto
offautoon
Roghnaigh an gcuireann giniúint na samhla siméadracht i bhfeidhm le On, an bhfágann sí ar lár í le Off, nó an gcinneann sí go huathoibríoch le Auto.
should_remeshroghnach
Cineálboolean
Réamhshocrútrue
Cumasaíonn nó díchumasaíonn sé céim an athmhogalaithe.
should_textureroghnach
Cineálboolean
Réamhshocrútrue
Cumasaíonn nó díchumasaíonn sé giniúint uigeachta.
enable_pbrroghnach
Cineálboolean
Réamhshocrúfalse
Cuireann sé léarscáileanna PBR miotalachta, garbhachta agus normálta 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'.
texture_promptroghnach
Cineálstring | null
≤ 600 gcarachtar
Treoracha téacs a stiúrann giniúint uigeachta.
texture_image_urlroghnach
Cineálurl · image
Íomhá thagartha 2D a stiúrann giniúint uigeachta.
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.
geometry_resolutionroghnach
Cineálenum
standard2k4k
Taifeach na céimseata; éilíonn 4k Meshy-7.1.
ultra_moderoghnach
Cineálboolean
Réamhshocrúfalse
Rogha as feidhm arna cur in ionad ag geometry_resolution, a ghlacann tosaíocht má sholáthraítear an dá cheann; úsáid geometry_resolution='2k' ina ionad.
riachtanach Ainm canónach, glactar leis freisin

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/v7.1/image-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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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,
    "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}Réad comhaid uigeachta in eagar atá struchtúrtha chun teacht le Meshy API.
seed
integer | nullSíol giniúna, nuair atá sé ar fáil.
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: Íomhá go 3D

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