Peke ki ngā ihirangi

Meshy V7 Text to 3D

Whakauru

id tauira 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ngā kōnae pēnei i te tauira: $ 1.20 1,200 whiwhinga API ka inea ō kōnae i mua i te whakahaere Whakahaerehia ki tēnei whārangi

Tikina he kī API
Meshy Kuputuhi ki te 3D #stylized#transform

Kuputuhi-ki-te-3D me Meshy 7: aratau arokite, oti rānei, āhuahanga 2k, PBR, whakarite kōhiwi me ngā kōwhiringa hākoritanga

Meshy · 3D

Kei konei tō hua tuatahi

Hangaia he tono ki raro nei, ka whakahaere mā tō kī API. Ka tāruatia ngā putanga ki tō mātou rokiroki, ka puritia mō ake tonu atu, mō rānei 7 rā mō te kore utu.

Hangaia he tono

Ka hangaia ngā mana whakahaere mai i te aronuinga o te tauira. Ka whakahoungia te waehere me te utu ina whakarerekē koe.

•e hiahiatia ana 88 / 600

Whakaahuatanga o te ahanoa hei whakaatu hei tauira 3D, kaua e neke ake i te 600 pūāhua.

mode taunoa full

Aratau whakaputa: mā te 'preview' ka puta te āhuahanga kāore he kakano, ko te 'full' ka puta he tauira whai kakano mā te whakakotahi i te preview me te refine.

geometry_resolution

Taumira āhuahanga mata; ko ngā kōwhiringa Meshy-7 e tautokona ana ko standard me 2k.

Arā atu 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

Ārahi i te tā-kakano mā tētahi tohutohu kuputuhi anō i te aratau 'full'; kāore ngā aratau kē e whakamahi.

Whakataka he kōnae,

Atahanga tohutoro 2D mō te whakaputa kakano, ka whakamahia i te aratau 'full' anake.

model_type taunoa standard

Aratau mata 3D: kōwhiria 'lowpoly' mō tētahi hua low-poly kua arotakengia mō ngā polygon mā; i tēnei aratau ka waiho e Meshy te topology, target_polycount, me should_remesh. Mō tētahi hua taipitopito teitei tikanga, kōwhiria 'standard', kōwhiria rānei 'smart-topology' hei whakamahi i Meshy-T2 i te wāhanga āhuahanga (preview) me te whakaputa motuhake i ngā wāhanga mā.

topology taunoa triangle

Kōwhiringa topology tauira i waenga i te Triangle mō te taipitopito āhuahanga me te Quad mō te māeneene o te mata.

symmetry_mode taunoa auto

Tautuhinga hangarite ka whakamahia i te whakaputa tauira.

pose_mode taunoa

Waiho te aho kia kau kia kaua e tohu i te tū o te tauira kua whakaputaina, tono rānei i te A-pose mā te 'a-pose', i te T-pose mā te 't-pose'.

taunoa 30000

Te whāinga tatau polygon, ka herea ki te 15,000 ina 'smart-topology' te model_type. Ki te waiho te whāinga i taua aratau, ka tīpako te taunoa iti iho a Meshy, arā 4,000.

taunoa 1.7

Tukuna te teitei tata o te kiripuaki ki te mita ina true te enable_rigging; ki te kore, kāore he pānga o tēnei uara.

taunoa 92

ID whakakorikori tatūkē o te whare pukapuka Meshy, ā, kei https://docs.meshy.ai/en/api/animation-library ngā mahi e wātea ana. Ka mana te whakamana me te whakamahinga ina true te enable_animation anake: ka whakakorehia ngā uara kei waho i te [0, 696] me te 422, ā, ko "Idle" te `0`.

Whakamahia anō tēnei kākano me te tohutohu kāore i whakarerekētia kia taea ai te whakaputa anō i tētahi hua o mua.

POST /run/meshy/v7/text-to-3d?wait=20 utu → $ 1.20
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Whakahaerehia tēnei tono

Ka noho tō kī ki tēnei pūtirotiro: ka tukuna ki te Doitong API anake, ā, ka tiakina ki te localStorage anake ina tohua e koe te Mahara. Tikina he kī API

Mō Meshy V7 Text to 3D

Ka whakaputa tauira 3D mai i tētahi `prompt` kia 600 pūāhua te mōrahi, me `enable_prompt_expansion` hei kōwhiringa. Ka whakahoki `mode` i te āhuahanga kāore he kakano, i te tauira whai kakano rānei. Kōwhiria standard, lowpoly, smart-topology rānei mā `model_type`, tautuhia `target_polycount` mai i te 100 ki te 300000, ā, kōwhiria te `geometry_resolution` standard, 2k rānei. Ka taea te tāpiri whakarite kōhiwi me ngā tatūkē hākoritanga mō ngā kiripuaki humanoid.

Ngā tawhā

IngoaMomo TaunoaE whakaaetia ana Whakamārama
prompte hiahiatia ana
Momostring
≤ 600 pūāhua
Whakaahuatanga o te ahanoa hei whakaatu hei tauira 3D, kaua e neke ake i te 600 pūāhua.
modekōwhiringa
Momoenum
Taunoafull
previewfull
Aratau whakaputa: mā te 'preview' ka puta te āhuahanga kāore he kakano, ko te 'full' ka puta he tauira whai kakano mā te whakakotahi i te preview me te refine.
seedkōwhiringa
Momointeger | null
Whakamahia anō tēnei kākano me te tohutohu kāore i whakarerekētia kia taea ai te whakaputa anō i tētahi hua o mua.
model_typekōwhiringa
Momoenum
Taunoastandard
standardlowpolysmart-topology
Aratau mata 3D: kōwhiria 'lowpoly' mō tētahi hua low-poly kua arotakengia mō ngā polygon mā; i tēnei aratau ka waiho e Meshy te topology, target_polycount, me should_remesh. Mō tētahi hua taipitopito teitei tikanga, kōwhiria 'standard', kōwhiria rānei 'smart-topology' hei whakamahi i Meshy-T2 i te wāhanga āhuahanga (preview) me te whakaputa motuhake i ngā wāhanga mā.
topologykōwhiringa
Momoenum
Taunoatriangle
quadtriangle
Kōwhiringa topology tauira i waenga i te Triangle mō te taipitopito āhuahanga me te Quad mō te māeneene o te mata.
target_polycountkōwhiringa
Momointeger
Taunoa30000
100 – 300,000
Te whāinga tatau polygon, ka herea ki te 15,000 ina 'smart-topology' te model_type. Ki te waiho te whāinga i taua aratau, ka tīpako te taunoa iti iho a Meshy, arā 4,000.
should_remeshkōwhiringa
Momoboolean
Taunoatrue
Waiho te remeshing ka whiwhi i te mata tapatoru mataora mā te tautuhi i tēnei ki te false; ki te kore, whakakāhia te wāhanga remesh.
symmetry_modekōwhiringa
Momoenum
Taunoaauto
offautoon
Tautuhinga hangarite ka whakamahia i te whakaputa tauira.
enable_pbrkōwhiringa
Momoboolean
Taunoafalse
Ka whakahaere i te whakaputanga o ngā mahere PBR metallic, roughness, me normal i te taha o te tae-pūtake.
is_a_t_posekōwhiringa
Momoboolean
Taunoafalse
Whakakā whakaputa T-pose mā te true; kua tawhito, ā, kua whakakapia e pose_mode.
pose_modekōwhiringa
Momoenum
Taunoa
a-poset-pose
Waiho te aho kia kau kia kaua e tohu i te tū o te tauira kua whakaputaina, tono rānei i te A-pose mā te 'a-pose', i te T-pose mā te 't-pose'.
enable_prompt_expansionkōwhiringa
Momoboolean
Taunoafalse
Tukua he tauira reo nui kia whakarangatira i te tohutohu ki ngā taipitopito. Mā tēnei whakawhānuitanga e noho pūmau ai te tikanga o te tohutohu.
texture_promptkōwhiringa
Momostring | null
≤ 600 pūāhua
Ārahi i te tā-kakano mā tētahi tohutohu kuputuhi anō i te aratau 'full'; kāore ngā aratau kē e whakamahi.
texture_image_urlkōwhiringa
Momourl · image
Atahanga tohutoro 2D mō te whakaputa kakano, ka whakamahia i te aratau 'full' anake.
enable_riggingkōwhiringa
Momoboolean
Taunoafalse
Rigging humanoid aunoa, tino whai hua mō ngā tauira humanoid e tino kitea ana ō rātou peka. Mā te whakakā ka rig te tauira kua whakaputaina, ka whakarato hoki i ngā whakakorikori taketake mō te hīkoi me te oma.
rigging_height_meterskōwhiringa
Momonumber
Taunoa1.7
> 0
Tukuna te teitei tata o te kiripuaki ki te mita ina true te enable_rigging; ki te kore, kāore he pānga o tēnei uara.
enable_animationkōwhiringa
Momoboolean
Taunoafalse
Mēnā ka whiwhi te tauira kua rigged i tētahi whakakorikori tatūkē, me true te enable_rigging.
animation_action_idkōwhiringa
Momointeger
Taunoa92
ID whakakorikori tatūkē o te whare pukapuka Meshy, ā, kei https://docs.meshy.ai/en/api/animation-library ngā mahi e wātea ana. Ka mana te whakamana me te whakamahinga ina true te enable_animation anake: ka whakakorehia ngā uara kei waho i te [0, 696] me te 422, ā, ko "Idle" te `0`.
enable_safety_checkerkōwhiringa
Momoboolean
Taunoatrue
Whakakā haumaru tukatuka-mua: mā te true ka noho te tirotiro haumaru tāuru hei whakaritenga mō te tukatuka.
geometry_resolutionkōwhiringa
Momoenum
standard2k
Taumira āhuahanga mata; ko ngā kōwhiringa Meshy-7 e tautokona ana ko standard me 2k.
ultra_modekōwhiringa
Momoboolean
Taunoafalse
Kōwhiringa kua tawhito, kua whakakapia e geometry_resolution, ā, koirā te mana ina tukuna ngā mea e rua; whakamahia geometry_resolution='2k' kē.
e hiahiatia ana

Mō ngā tawhā kōnae, whakamahia he URL tūmatanui https://, he URI data: tae atu ki te 10 MB, he file_url rānei o tētahi tukuake. Ngā kōnae

Putanga

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ō kōnae, māu e whiriwhiriKo ia url o outputs[] he tārua kei tō mātou rokiroki: ka puritia mō ake tonu atu (ka utua ia GB-marama) mō rānei 7 rā mō te kore utu, e ai ki ngā tautuhinga o tō pūkete, ki te ?storage= rānei.
He ōrite te hanga ki ia tauiratype, url, content_type, width, height me duration, mō ngā pikitia, ataata me te oro. Ko output te ahanoa hua ake o te tauira.
Ngā āpure o te putanga
animation_glb
object {url, content_type, file_name, file_size} | nullHua whakakorikori kei roto te tauira 3D hei GLB; kāore tēnei hua e whakahokia mēnā kāore te enable_animation i te true.
animation_fbx
object {url, content_type, file_name, file_size} | nullHua whakakorikori kei roto te tauira 3D hei FBX; kāore tēnei hua e whakahokia mēnā kāore te enable_animation i te true.
model_glb
object {url, content_type, file_name, file_size}Kōnae GLB kei roto te mea 3D kua whakaputaina.
thumbnail
object {url, content_type, file_name, file_size} | nullAtahanga karakōnui e whakaatu ana i te arokite o te tauira kua whakaputaina.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Hononga ki te tauira 3D i ngā momo hōputu.
texture_urls
array of object {base_color, metallic, normal, roughness}Ngā kōnae kakano kua whakaaturia hei huinga ahanoa.
seed
integer | nullTe uara kākano i whakamahia i te whakaputanga.
prompt
stringTohutohu kuputuhi i tukuna mō te whakaputa.
actual_prompt
string | nullTohutohu i whakamahia tūturu mō te whakaputa i te wā i whakakāhia ai te whakawhānui tohutohu.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullHua rigging i tukuna hei kōnae kiripuaki GLB; kāore e puta i te whakautu mēnā kāore te enable_rigging i te true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullHua rigging i tukuna hei kōnae kiripuaki FBX; kāore e puta i te whakautu mēnā kāore te enable_rigging i te true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullNgā whakakorikori hīkoi me te oma taketake, ka whakaurua ina true anake te enable_rigging.
rig_task_id
string | nullKaitāutu mō te tūmahi rigging; ka whakaurua ina true anake te enable_rigging.

Ētahi atu tauira: Kuputuhi ki te 3D

Mō ngā āpiha AI: kei te wātea tēnei whārangi hei Markdown ki https://doitong.com/mi/developers/models/meshy/v7/text-to-3d.md. Ngā tauira me ngā aratohu katoa: https://doitong.com/developers/llms.txt