Ruka hadi kwenye maudhui

Meshy V7 Text to 3D

Unganisha

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

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 Maandishi hadi 3D #stylized#transform

Maandishi hadi 3D kwa Meshy 7: hali ya preview au full, jiometri ya 2k, PBR, rigging na chaguo za uhuishaji

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 88 / 600

Maelezo ya kitu kitakachowakilishwa kama modeli ya 3D, yenye kikomo cha herufi 600.

mode chaguomsingi full

Hali ya uzalishaji: 'preview' hutoa jiometri bila tekstura, huku 'full' ikitoa modeli yenye tekstura kwa kuchanganya preview na refine.

geometry_resolution

Mwonekano wa jiometri ya meshi; chaguo za Meshy-7 zinazotumika ni standard na 2k.

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

Elekeza uwekaji wa tekstura kwa kidokezo cha ziada cha maandishi katika hali ya 'full'; hali nyingine hazitumii.

Dondosha faili, au

Picha ya marejeleo ya 2D kwa uzalishaji wa tekstura, inayotumika tu katika hali ya 'full'.

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 wakati wa hatua ya jiometri (preview) 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

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

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

Tumia tena mbegu hii pamoja na kidokezo kisichobadilishwa ili kwa kawaida kuzalisha tena tokeo la awali.

POST /run/meshy/v7/text-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/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"

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 Text to 3D

Huzalisha modeli ya 3D kutoka kwa `prompt` yenye hadi herufi 600, ikiwa na `enable_prompt_expansion` ya hiari. `mode` hurejesha jiometri isiyo na tekstura au modeli yenye tekstura. Chagua standard, lowpoly au smart-topology kupitia `model_type`, weka `target_polycount` kutoka 100 hadi 300000, na uchague standard au 2k `geometry_resolution`. Rigging na mipangilio ya uhuishaji inaweza kuongezwa kwa wahusika wa humanoid.

Vigezo

JinaAina ChaguomsingiInaruhusiwa Maelezo
promptinahitajika
Ainastring
≤ herufi 600
Maelezo ya kitu kitakachowakilishwa kama modeli ya 3D, yenye kikomo cha herufi 600.
modesi lazima
Ainaenum
Chaguomsingifull
previewfull
Hali ya uzalishaji: 'preview' hutoa jiometri bila tekstura, huku 'full' ikitoa modeli yenye tekstura kwa kuchanganya preview na refine.
seedsi lazima
Ainainteger | null
Tumia tena mbegu hii pamoja na kidokezo kisichobadilishwa ili kwa kawaida kuzalisha tena tokeo la awali.
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 wakati wa hatua ya jiometri (preview) 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.
should_remeshsi lazima
Ainaboolean
Chaguomsingitrue
Ruka kutengeneza meshi upya na upokee meshi ghafi ya pembetatu kwa kuweka hii kuwa false; vinginevyo wezesha hatua ya kutengeneza meshi upya.
symmetry_modesi lazima
Ainaenum
Chaguomsingiauto
offautoon
Mipangilio ya ulinganifu inayotumika wakati wa kuzalisha modeli.
enable_pbrsi lazima
Ainaboolean
Chaguomsingifalse
Hudhibiti uzalishaji wa 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'.
enable_prompt_expansionsi lazima
Ainaboolean
Chaguomsingifalse
Ruhusu modeli kubwa ya lugha kuimarisha kidokezo kwa maelezo. Kuwasha upanuzi huu hakubadilishi maana ya kidokezo.
texture_promptsi lazima
Ainastring | null
≤ herufi 600
Elekeza uwekaji wa tekstura kwa kidokezo cha ziada cha maandishi katika hali ya 'full'; hali nyingine hazitumii.
texture_image_urlsi lazima
Ainaurl · image
Picha ya marejeleo ya 2D kwa uzalishaji wa tekstura, inayotumika tu katika hali ya 'full'.
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 ya meshi; chaguo za Meshy-7 zinazotumika ni standard na 2k.
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

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/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"
  }
}
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 | nullThamani ya mbegu inayotumika wakati wa uzalishaji.
prompt
stringKidokezo cha maandishi kilichotolewa kwa uzalishaji.
actual_prompt
string | nullKidokezo kilichotumika hasa kwenye uzalishaji wakati upanuzi wa kidokezo uliwezeshwa.
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: Maandishi hadi 3D

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