Ruka hadi kwenye maudhui
Kiswahili
Pata ufunguo wa API

Meshy V7 Multi Image to 3D

Unganisha

Kitambulisho cha modeli meshy/v7/multi-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/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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 #stylized#transform

Huunda modeli moja ya 3D kutoka mitazamo 1 hadi 4 ya kitu kilekile, ikiwa na vidhibiti vya poligoni na topology

OpenAPI Markdown
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_urls
Dondosha faili, au

Seti ya picha kwa uundaji wa 3D, inayokubali .jpg, .jpeg, .png pamoja na AVIF/HEIF zenye ubadilishaji wa kiotomatiki. Toa mionekano 1 hadi 4 inayoonyesha kitu kimoja kutoka pembe tofauti; maingizo yanayozidi 4 ya kwanza hayatumiki.

geometry_resolution

Mwonekano wa jiometri; 4k haipatikani kwa uzalishaji kutoka kwa picha nyingi.

Ya kina texture_prompt · texture_image_url · topology · symmetry_mode · pose_mode · target_polycount · rigging_height_meters · animation_action_id · should_remesh · enable_pbr · is_a_t_pose · enable_safety_checker
0 / 600

Mwongozo wa uwekaji wa tekstura unaotolewa kama kidokezo cha maandishi, unaohitaji should_texture kuwa true.

Dondosha faili, au

Mwongozo wa uwekaji wa tekstura unaotolewa kama picha ya 2D, unaohitaji should_texture kuwa true.

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

Mipangilio ya ulinganifu inayotumika wakati wa kuzalisha modeli.

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

chaguomsingi 30000

Idadi inayotakiwa ya poligoni kwa modeli ya tokeo.

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/multi-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/multi-image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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 V7 Multi Image to 3D

Hujenga upya kitu kimoja kutoka kwa `image_urls`, inayopokea picha moja hadi nne za kitu hicho kutoka pembe tofauti. Weka `topology` kuwa quad au triangle na `target_polycount` kutoka 100 hadi 300000, kisha chagua standard au 2k `geometry_resolution`. Uwekaji wa tekstura ni wa hiari kupitia `should_texture`, pamoja na ramani za PBR, hali ya mkao, rigging na uhuishaji. Matokeo yanajumuisha GLB na fomati nyingine.

Vigezo

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

JinaAina ChaguomsingiInaruhusiwa Maelezo
image_urlsinahitajika images
Ainaurl[] · image
Seti ya picha kwa uundaji wa 3D, inayokubali .jpg, .jpeg, .png pamoja na AVIF/HEIF zenye ubadilishaji wa kiotomatiki. Toa mionekano 1 hadi 4 inayoonyesha kitu kimoja kutoka pembe tofauti; maingizo yanayozidi 4 ya kwanza hayatumiki.
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
Idadi inayotakiwa ya poligoni kwa modeli ya tokeo.
symmetry_modesi lazima
Ainaenum
Chaguomsingiauto
offautoon
Mipangilio ya ulinganifu inayotumika wakati wa kuzalisha modeli.
should_remeshsi lazima
Ainaboolean
Chaguomsingitrue
Ikiwa hatua ya kutengeneza meshi upya iendeshwe. Kuweka hii kuwa false hutoa meshi ya pembetatu; topology na target_polycount hup ignored.
should_texturesi lazima
Ainaboolean
Chaguomsingitrue
Huwezesha au kuzima uzalishaji wa tekstura.
enable_pbrsi lazima
Ainaboolean
Chaguomsingifalse
Swichi ya ziada ya tokeo la PBR, inayopatikana tu should_texture ikiwa true; huongeza ramani 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
Mwongozo wa uwekaji wa tekstura unaotolewa kama kidokezo cha maandishi, unaohitaji should_texture kuwa true.
texture_image_urlsi lazima
Ainaurl · image
Mwongozo wa uwekaji wa tekstura unaotolewa kama picha ya 2D, unaohitaji should_texture kuwa true.
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
standard2k
Mwonekano wa jiometri; 4k haipatikani kwa uzalishaji kutoka kwa picha nyingi.
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/multi-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_urls": [
      "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}Faili za tekstura zinazowakilishwa kama safu ya vitu.
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/multi-image-to-3d.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt