Sleppa yfir í efni

Meshy V7 Text to 3D

Tengja

Auðkenni líkans 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"

Skrár eins og dæmið: 1,20 $ 1.200 API-inneignir · ≈ 129,10 ₽ skrárnar þínar eru mældar áður en keyrt er Keyra á þessari síðu

Fá API-lykil
Meshy Texti í 3D #stylized#transform

Texti í 3D með Meshy 7: forskoðunar- eða fullur hamur, 2k rúmfræði og valkostir fyrir PBR, beinagrind og hreyfimynd

Meshy · 3D

Fyrsta niðurstaðan þín birtist hér

Búðu til beiðni hér að neðan og keyrðu hana með API-lyklinum þínum. Úttök eru afrituð í geymsluna okkar og geymd að eilífu eða 7 dagar án kostnaðar.

Búa til beiðni

Stýringar eru búnar til út frá líkanaskemanu. Kóðinn og verðið uppfærast þegar þú breytir þeim.

•áskilið 88 / 600

Lýsing á hlutnum sem á að tákna sem 3D-líkan, takmörkuð við 600 stafi.

mode sjálfgefið full

Efnisgerð: 'preview' skilar rúmfræði án áferðar, en 'full' skilar áferðarlíkani með því að sameina preview og refine.

geometry_resolution

Upplausn rúmfræði netsins; studdar Meshy-7-stillingar eru standard og 2k.

Ítarlegt 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

Stýrðu áferð með viðbótartextakvaðningu í 'full'-stillingu; aðrar stillingar nota hana ekki.

Slepptu skrá eða

2D-viðmiðunarmynd fyrir áferðargerð, aðeins beitt í 'full'-stillingu.

model_type sjálfgefið standard

3D-netstilling: veldu 'lowpoly' fyrir lágfjölgunarúttak sem er fínstillt fyrir hreinni marghyrninga; í þessari stillingu hunsar Meshy topology, target_polycount og should_remesh. Fyrir hefðbundið úttak með miklum smáatriðum skaltu velja 'standard', eða 'smart-topology' til að nota Meshy-T2 í rúmfræðiskrefinu (preview) og fá hreina hluta sem eru myndaðir aðskildir frá upphafi.

topology sjálfgefið triangle

Val á grannfræði líkans milli Triangle fyrir rúmfræðileg smáatriði og Quad fyrir slétt yfirborð.

symmetry_mode sjálfgefið auto

Samhverfustilling sem beitt er við gerð líkansins.

pose_mode sjálfgefið

Skildu strenginn eftir tóman til að tilgreina ekki stellingu myndaða líkansins, eða óskaðu eftir A-stellingu með 'a-pose' eða T-stellingu með 't-pose'.

sjálfgefið 30000

Markfjöldi marghyrninga, takmarkaður við 15,000 þegar model_type er 'smart-topology'. Ef markið er ekki gefið upp í þeirri stillingu er lægra sjálfgefið gildi Meshy, 4,000, valið.

sjálfgefið 1.7

Gefðu upp áætlaða hæð persónu í metrum þegar enable_rigging er true; annars hefur þetta gildi engin áhrif.

sjálfgefið 92

Auðkenni hreyfingarforstillingar úr Meshy-safninu, með tiltækum aðgerðum skráðum á https://docs.meshy.ai/en/api/animation-library. Staðfesting og notkun eiga aðeins við þegar enable_animation er true: gildi utan [0, 696] er hafnað með 422 og "Idle" samsvarar `0`.

Endurnotaðu þetta fræ ásamt óbreyttri kvaðningu til að endurskapa yfirleitt fyrri niðurstöðu.

POST /run/meshy/v7/text-to-3d?wait=20 verðtilboð → 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"

Keyra þessa beiðni

Lykillinn þinn er áfram í þessum vafra: hann er aðeins sendur til Doitong API og vistaður í localStorage aðeins ef þú hakar við Muna. Fá API-lykil

Um Meshy V7 Text to 3D

Býr til 3D-líkan úr `prompt` með allt að 600 stöfum, með valkvæðri `enable_prompt_expansion`. `mode` skilar annaðhvort óáferðarlagðri rúmfræði eða áferðarlögðu líkani. Veldu standard, lowpoly eða smart-topology með `model_type`, stilltu `target_polycount` frá 100 til 300000 og veldu standard eða 2k `geometry_resolution`. Hægt er að bæta beinagrind og hreyfimyndaforstillingum við manngerðar persónur.

Færibreytur

HeitiGerð SjálfgefiðLeyfilegt Lýsing
promptáskilið
Gerðstring
≤ 600 stafir
Lýsing á hlutnum sem á að tákna sem 3D-líkan, takmörkuð við 600 stafi.
modevalfrjálst
Gerðenum
Sjálfgefiðfull
previewfull
Efnisgerð: 'preview' skilar rúmfræði án áferðar, en 'full' skilar áferðarlíkani með því að sameina preview og refine.
seedvalfrjálst
Gerðinteger | null
Endurnotaðu þetta fræ ásamt óbreyttri kvaðningu til að endurskapa yfirleitt fyrri niðurstöðu.
model_typevalfrjálst
Gerðenum
Sjálfgefiðstandard
standardlowpolysmart-topology
3D-netstilling: veldu 'lowpoly' fyrir lágfjölgunarúttak sem er fínstillt fyrir hreinni marghyrninga; í þessari stillingu hunsar Meshy topology, target_polycount og should_remesh. Fyrir hefðbundið úttak með miklum smáatriðum skaltu velja 'standard', eða 'smart-topology' til að nota Meshy-T2 í rúmfræðiskrefinu (preview) og fá hreina hluta sem eru myndaðir aðskildir frá upphafi.
topologyvalfrjálst
Gerðenum
Sjálfgefiðtriangle
quadtriangle
Val á grannfræði líkans milli Triangle fyrir rúmfræðileg smáatriði og Quad fyrir slétt yfirborð.
target_polycountvalfrjálst
Gerðinteger
Sjálfgefið30000
100 – 300.000
Markfjöldi marghyrninga, takmarkaður við 15,000 þegar model_type er 'smart-topology'. Ef markið er ekki gefið upp í þeirri stillingu er lægra sjálfgefið gildi Meshy, 4,000, valið.
should_remeshvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Slepptu endurnetun og fáðu hráa þríhyrningsnetið með því að stilla þetta á false; annars skaltu virkja endurnetunarskrefið.
symmetry_modevalfrjálst
Gerðenum
Sjálfgefiðauto
offautoon
Samhverfustilling sem beitt er við gerð líkansins.
enable_pbrvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Stýrir myndun málm-, hrjúfleika- og normal-PBR-korta ásamt grunnlitnum.
is_a_t_posevalfrjálst
Gerðboolean
Sjálfgefiðfalse
Rofi fyrir myndun T-stellingar sem virkjast með true; úreltur og leystur af hólmi af pose_mode.
pose_modevalfrjálst
Gerðenum
Sjálfgefið
a-poset-pose
Skildu strenginn eftir tóman til að tilgreina ekki stellingu myndaða líkansins, eða óskaðu eftir A-stellingu með 'a-pose' eða T-stellingu með 't-pose'.
enable_prompt_expansionvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Leyfðu stórmálslíkani að bæta upplýsingum við kvaðninguna. Þessi útvíkkun breytir ekki merkingu kvaðningarinnar.
texture_promptvalfrjálst
Gerðstring | null
≤ 600 stafir
Stýrðu áferð með viðbótartextakvaðningu í 'full'-stillingu; aðrar stillingar nota hana ekki.
texture_image_urlvalfrjálst
Gerðurl · image
2D-viðmiðunarmynd fyrir áferðargerð, aðeins beitt í 'full'-stillingu.
enable_riggingvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Sjálfvirk beinagrindarsetning mannveru, áhrifaríkust fyrir mannleg líkön þar sem útlimirnir eru greinilega aðgreindir. Með virkjun er beinagrind sett á myndaða líkanið og einföldum göngu- og hlaupahreyfingum bætt við.
rigging_height_metersvalfrjálst
Gerðnumber
Sjálfgefið1.7
> 0
Gefðu upp áætlaða hæð persónu í metrum þegar enable_rigging er true; annars hefur þetta gildi engin áhrif.
enable_animationvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Hvort beinagrindarsett líkan fái forstillta hreyfingu, sem krefst þess að enable_rigging sé true.
animation_action_idvalfrjálst
Gerðinteger
Sjálfgefið92
Auðkenni hreyfingarforstillingar úr Meshy-safninu, með tiltækum aðgerðum skráðum á https://docs.meshy.ai/en/api/animation-library. Staðfesting og notkun eiga aðeins við þegar enable_animation er true: gildi utan [0, 696] er hafnað með 422 og "Idle" samsvarar `0`.
enable_safety_checkervalfrjálst
Gerðboolean
Sjálfgefiðtrue
Öryggisathugunarrofi fyrir forvinnslu: true gerir öryggisathugun á inntaki að forsendu úrvinnslu.
geometry_resolutionvalfrjálst
Gerðenum
standard2k
Upplausn rúmfræði netsins; studdar Meshy-7-stillingar eru standard og 2k.
ultra_modevalfrjálst
Gerðboolean
Sjálfgefiðfalse
Úreltur valkostur sem geometry_resolution leysir af hólmi og hefur forgang ef báðir eru gefnir upp; notaðu geometry_resolution='2k' í staðinn.
áskilið

Skrárfæribreytur taka við opinberri https://-vefslóð, data:-URI allt að 10 MB eða file_url fyrir upphleðslu. Skrár

Úttak

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"
  }
}
Skrárnar þínar, þitt valHvert outputs[].url er afrit í geymslunni okkar: geymt að eilífu (greitt fyrir hvert GB-mánuðargildi) eða 7 dagar án kostnaðar, eftir stillingu aðgangsins þíns eða ?storage=.
Sama lögun í öllum líkönumtype, url, content_type, width, height og duration, jafnt fyrir myndir, myndbönd og hljóð. output er eigið niðurstöðuhlutur líkansins.
Reitir úttaks
animation_glb
object {url, content_type, file_name, file_size} | nullNiðurstaða hreyfingar sem inniheldur 3D-líkanið sem GLB; svarið sleppir þessari niðurstöðu nema enable_animation sé true.
animation_fbx
object {url, content_type, file_name, file_size} | nullNiðurstaða hreyfingar sem inniheldur 3D-líkanið sem FBX; svarið sleppir þessari niðurstöðu nema enable_animation sé true.
model_glb
object {url, content_type, file_name, file_size}GLB-skrá sem inniheldur 3D-hlutinn sem búinn er til.
thumbnail
object {url, content_type, file_name, file_size} | nullSmámynd sem sýnir forskoðun á líkaninu sem búið er til.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Tenglar á 3D-líkanið á ýmsum sniðum.
texture_urls
array of object {base_color, metallic, normal, roughness}Áferðarskrár táknaðar sem fylki hluta.
seed
integer | nullFrægildi notað við efnisgerð.
prompt
stringTextakvaðning sem gefin er upp fyrir efnisgerð.
actual_prompt
string | nullKvaðningin sem var í raun beitt við efnisgerð þegar kvaðningarútvíkkun var virkjuð.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullNiðurstaða beinagrindarsetningar skilað sem GLB-persónuskrá; vantar í svarið nema enable_rigging sé true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullNiðurstaða beinagrindarsetningar skilað sem FBX-persónuskrá; vantar í svarið nema enable_rigging sé true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullEinfaldar göngu- og hlaupahreyfingar, aðeins með ef enable_rigging er true.
rig_task_id
string | nullAuðkenni beinagrindarsetningarverkefnis; aðeins með ef enable_rigging er true.

Fleiri líkön: Texti í 3D

Fyrir gervigreindarþjóna: þessi síða á Markdown-sniði er á https://doitong.com/is/developers/models/meshy/v7/text-to-3d.md. Öll líkön og leiðbeiningar: https://doitong.com/developers/llms.txt