Ruka hadi kwenye maudhui

Meshy 7.1 Image to 3D

Unganisha

Kitambulisho cha modeli 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"

Faili kama mfano: $ 1.20 salio za API 1,200 · ≈ ₽ 129.10 faili zako hupimwa kabla ya kuendesha Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Meshy Picha hadi 3D Pato la 4K #3d#image-to-3d#textures#pbr

Uzalishaji wa 3D kutoka picha moja unaoongeza chaguo la azimio la jiometri la 4k

Meshy · 3D

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

•inahitajika image_url
Dondosha faili, au

Toa picha chanzo kwa uundaji wa 3D kwa URL au URI ya data ya base64, ukitumia .jpg, .jpeg, .png, AVIF au HEIF. Ubadilishaji wa kiotomatiki hushughulikia maingizo ya AVIF na HEIF.

Ya kina 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

Maagizo ya maandishi yanayoelekeza uzalishaji wa tekstura.

Dondosha faili, au

Picha ya marejeleo ya 2D inayoelekeza uzalishaji wa tekstura.

model_type chaguomsingi standard

Hali ya meshi ya 3D: chagua 'lowpoly' kwa tokeo la low-poly lililoboreshwa kwa poligoni safi zaidi; katika hali hii Meshy hupuuza topology, target_polycount na should_remesh. Kwa tokeo la kawaida lenye maelezo mengi chagua 'standard', au chagua 'smart-topology' kutumia Meshy-T2 na kupata sehemu safi zinazozalishwa kando tangu mwanzo.

topology chaguomsingi triangle

Chaguo la topolojia ya modeli kati ya Triangle kwa maelezo ya kijiometri na Quad kwa ulaini wa uso.

symmetry_mode chaguomsingi auto

Chagua ikiwa uzalishaji wa modeli ulazimishe ulinganifu kwa On, uuache kwa Off, au uamue kiotomatiki kwa Auto.

pose_mode chaguomsingi

Acha mfuatano ukiwa tupu ili usibainishe mkao wa modeli inayozalishwa, au omba mkao wa A kwa 'a-pose' au mkao wa T kwa 't-pose'.

geometry_resolution

Mwonekano wa jiometri; 4k inahitaji Meshy-7.1.

chaguomsingi 30000

Lengo la idadi ya poligoni, lililowekewa kikomo cha 15,000 wakati model_type ni 'smart-topology'. Kuacha lengo katika hali hiyo huchagua chaguo-msingi la chini la Meshy la 4,000.

chaguomsingi 1.7

Toa urefu unaokadiriwa wa mhusika kwa mita wakati enable_rigging ni true; vinginevyo thamani hii haina athari.

chaguomsingi 92

Kitambulisho cha uhuishaji wa Meshy library, chenye vitendo vinavyopatikana kwenye https://docs.meshy.ai/en/api/animation-library. Uthibitishaji na matumizi hutokea tu enable_animation ikiwa true: thamani zilizo nje ya [0, 696] hukataliwa kwa 422, na "Idle" inalingana na `0`.

POST /run/meshy/v7.1/image-to-3d?wait=20 makadirio → $ 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"

Endesha ombi hili

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Pata ufunguo wa API

Kuhusu Meshy 7.1 Image to 3D

Huunda modeli ya 3D kutoka kwenye picha moja katika `image_url`. `geometry_resolution` hukubali standard, 2k au 4k, huku 4k ikiwa maalum kwa toleo hili. `model_type` inajumuisha standard, lowpoly na smart-topology, na `target_polycount` huanzia 100 hadi 300000. Tekstura, ramani za PBR, hali ya mkao, rigging ya humanoid na mipangilio ya uhuishaji yote ni ya hiari.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo
image_urlinahitajika image
Ainaurl · image
Toa picha chanzo kwa uundaji wa 3D kwa URL au URI ya data ya base64, ukitumia .jpg, .jpeg, .png, AVIF au HEIF. Ubadilishaji wa kiotomatiki hushughulikia maingizo ya AVIF na HEIF.
model_typesi lazima
Ainaenum
Chaguomsingistandard
standardlowpolysmart-topology
Hali ya meshi ya 3D: chagua 'lowpoly' kwa tokeo la low-poly lililoboreshwa kwa poligoni safi zaidi; katika hali hii Meshy hupuuza topology, target_polycount na should_remesh. Kwa tokeo la kawaida lenye maelezo mengi chagua 'standard', au chagua 'smart-topology' kutumia Meshy-T2 na kupata sehemu safi zinazozalishwa kando tangu mwanzo.
topologysi lazima
Ainaenum
Chaguomsingitriangle
quadtriangle
Chaguo la topolojia ya modeli kati ya Triangle kwa maelezo ya kijiometri na Quad kwa ulaini wa uso.
target_polycountsi lazima
Ainainteger
Chaguomsingi30000
100 – 300,000
Lengo la idadi ya poligoni, lililowekewa kikomo cha 15,000 wakati model_type ni 'smart-topology'. Kuacha lengo katika hali hiyo huchagua chaguo-msingi la chini la Meshy la 4,000.
symmetry_modesi lazima
Ainaenum
Chaguomsingiauto
offautoon
Chagua ikiwa uzalishaji wa modeli ulazimishe ulinganifu kwa On, uuache kwa Off, au uamue kiotomatiki kwa Auto.
should_remeshsi lazima
Ainaboolean
Chaguomsingitrue
Huwezesha au kuzima hatua ya kutengeneza meshi upya.
should_texturesi lazima
Ainaboolean
Chaguomsingitrue
Huwezesha au kuzima uzalishaji wa tekstura.
enable_pbrsi lazima
Ainaboolean
Chaguomsingifalse
Huongeza ramani za PBR za metali, ukwaruzaji na kawaida pamoja na rangi msingi.
is_a_t_posesi lazima
Ainaboolean
Chaguomsingifalse
Swichi ya uzalishaji wa mkao wa T inayowezeshwa na true; imepitwa na wakati na imebadilishwa na pose_mode.
pose_modesi lazima
Ainaenum
Chaguomsingi
a-poset-pose
Acha mfuatano ukiwa tupu ili usibainishe mkao wa modeli inayozalishwa, au omba mkao wa A kwa 'a-pose' au mkao wa T kwa 't-pose'.
texture_promptsi lazima
Ainastring | null
≤ herufi 600
Maagizo ya maandishi yanayoelekeza uzalishaji wa tekstura.
texture_image_urlsi lazima
Ainaurl · image
Picha ya marejeleo ya 2D inayoelekeza uzalishaji wa tekstura.
enable_riggingsi lazima
Ainaboolean
Chaguomsingifalse
Uwekaji wa mifupa kiotomatiki kwa humanoid, unaofaa zaidi kwa modeli za humanoid ambazo viungo vyake vinatofautika wazi. Kuiwezesha huwekea modeli inayozalishwa mifupa na kutoa uhuishaji wa msingi wa kutembea na kukimbia.
rigging_height_meterssi lazima
Ainanumber
Chaguomsingi1.7
> 0
Toa urefu unaokadiriwa wa mhusika kwa mita wakati enable_rigging ni true; vinginevyo thamani hii haina athari.
enable_animationsi lazima
Ainaboolean
Chaguomsingifalse
Ikiwa modeli yenye mifupa itapokea uhuishaji wa chaguomsingi, ambao unahitaji enable_rigging kuwa true.
animation_action_idsi lazima
Ainainteger
Chaguomsingi92
Kitambulisho cha uhuishaji wa Meshy library, chenye vitendo vinavyopatikana kwenye https://docs.meshy.ai/en/api/animation-library. Uthibitishaji na matumizi hutokea tu enable_animation ikiwa true: thamani zilizo nje ya [0, 696] hukataliwa kwa 422, na "Idle" inalingana na `0`.
enable_safety_checkersi lazima
Ainaboolean
Chaguomsingitrue
Swichi ya ukaguzi wa usalama wa uchakataji: true hufanya ukaguzi wa usalama wa ingizo kuwa sharti la uchakataji.
geometry_resolutionsi lazima
Ainaenum
standard2k4k
Mwonekano wa jiometri; 4k inahitaji Meshy-7.1.
ultra_modesi lazima
Ainaboolean
Chaguomsingifalse
Chaguo lililopitwa na wakati lililobadilishwa na geometry_resolution, ambayo hushinda ikiwa zote zimetolewa; tumia geometry_resolution='2k' badala yake.
inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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"
  }
}
Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.
Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.
Sehemu za tokeo
animation_glb
object {url, content_type, file_name, file_size} | nullTokeo la uhuishaji lenye modeli ya 3D kama GLB; jibu huacha tokeo hili isipokuwa enable_animation iwe true.
animation_fbx
object {url, content_type, file_name, file_size} | nullTokeo la uhuishaji lenye modeli ya 3D kama FBX; jibu huacha tokeo hili isipokuwa enable_animation iwe true.
model_glb
object {url, content_type, file_name, file_size}Faili la GLB lililo na kitu cha 3D kilichozalishwa.
thumbnail
object {url, content_type, file_name, file_size} | nullKijipicha kinachoonyesha onyesho la modeli iliyozalishwa.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Viungo vya modeli ya 3D katika miundo mbalimbali.
texture_urls
array of object {base_color, metallic, normal, roughness}Vitu vya faili za tekstura katika safu iliyoundwa kulingana na Meshy API.
seed
integer | nullMbegu ya uzalishaji, inapopatikana.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullTokeo la uwekaji mifupa linalotolewa kama faili la mhusika wa GLB; halipo kwenye jibu isipokuwa enable_rigging iwe true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullTokeo la uwekaji mifupa linalotolewa kama faili la mhusika wa FBX; halipo kwenye jibu isipokuwa enable_rigging iwe true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullUhuishaji wa msingi wa kutembea na kukimbia, unaojumuishwa tu ikiwa enable_rigging ni true.
rig_task_id
string | nullKitambulisho cha kazi ya uwekaji mifupa; kinajumuishwa tu ikiwa enable_rigging ni true.

Miundo zaidi: Picha hadi 3D

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/meshy/v7.1/image-to-3d.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt