Pāriet uz saturu

Meshy V7 Text to 3D

Integrēt

Modeļa id 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, piemēram, paraugā: 1,20 $ 1200 API kredītu · ≈ 129,10 ₽ jūsu faili tiek izmērīti pirms izpildes Izpildīt šajā lapā

Iegūt API atslēgu
Meshy Teksts uz 3D #stylized#transform

Teksta pārveide uz 3D ar Meshy 7: priekšskatījuma vai pilnais režīms, 2k ģeometrija, PBR, skeleta un animācijas iespējas

Meshy · 3D

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

•obligāts 88 / 600

Objekta apraksts, kas jāattēlo kā 3D modelis; ierobežots līdz 600 rakstzīmēm.

mode noklusējums full

Ģenerēšanas režīms: 'preview' izvada ģeometriju bez tekstūrām, savukārt 'full' izvada teksturētu modeli, apvienojot preview un refine.

geometry_resolution

Tīkla ģeometrijas izšķirtspēja; atbalstītās Meshy-7 opcijas ir standard un 2k.

Papildu 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

Vadiet teksturēšanu ar papildu teksta uzvedni 'full' režīmā; citi režīmi to neizmanto.

Nometiet failu vai

2D atsauces attēls tekstūras ģenerēšanai, kas tiek izmantots tikai 'full' režīmā.

model_type noklusējums standard

3D tīkla režīms: izvēlieties 'lowpoly', lai iegūtu zemās izšķirtspējas tīklu ar tīrākiem daudzstūriem; šajā režīmā Meshy ignorē topology, target_polycount un should_remesh. Parastam augstas detalizācijas rezultātam izvēlieties 'standard', bet 'smart-topology' izmanto Meshy-T2 ģeometrijas (preview) posmā un iegūst tīras daļas, kas jau sākotnēji ģenerētas atsevišķi.

topology noklusējums triangle

Modeļa topoloģijas izvēle starp Triangle ģeometriskām detaļām un Quad virsmas gludumam.

symmetry_mode noklusējums auto

Simetrijas iestatījums, ko izmanto modeļa ģenerēšanas laikā.

pose_mode noklusējums

Atstājiet virkni tukšu, lai nenorādītu ģenerētā modeļa pozu, vai pieprasiet A-pozīciju ar 'a-pose' vai T-pozīciju ar 't-pose'.

noklusējums 30000

Daudzstūru skaita mērķis; ja model_type ir 'smart-topology', tas nepārsniedz 15,000. Ja šajā režīmā mērķis nav norādīts, tiek izmantots Meshy zemākais noklusējums — 4,000.

noklusējums 1.7

Norādiet aptuveno tēla augstumu metros, ja enable_rigging ir true; pretējā gadījumā šai vērtībai nav ietekmes.

noklusējums 92

Meshy bibliotēkas animācijas iepriekš iestatītais ID; pieejamās darbības uzskaitītas vietnē https://docs.meshy.ai/en/api/animation-library. Validācija un lietošana attiecas tikai tad, ja enable_animation ir true: vērtības ārpus [0, 696] tiek noraidītas ar 422, un "Idle" atbilst `0`.

Atkārtoti izmantojiet šo sākumstāvokli kopā ar nemainītu uzvedni, lai parasti atkārtotu iepriekšējo rezultātu.

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

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Meshy V7 Text to 3D

Ģenerē 3D modeli no `prompt` līdz 600 rakstzīmēm ar izvēles `enable_prompt_expansion`. `mode` atgriež neizteksturētu ģeometriju vai teksturētu modeli. Izmantojot `model_type`, izvēlieties standard, lowpoly vai smart-topology, iestatiet `target_polycount` no 100 līdz 300000 un izvēlieties standard vai 2k `geometry_resolution`. Humanoīdiem tēliem var pievienot skeletu un animācijas sākotnes.

Parametri

NosaukumsTips NoklusējumsAtļauts Apraksts
promptobligāts
Tipsstring
≤ 600 rakstzīmju
Objekta apraksts, kas jāattēlo kā 3D modelis; ierobežots līdz 600 rakstzīmēm.
modeneobligāts
Tipsenum
Noklusējumsfull
previewfull
Ģenerēšanas režīms: 'preview' izvada ģeometriju bez tekstūrām, savukārt 'full' izvada teksturētu modeli, apvienojot preview un refine.
seedneobligāts
Tipsinteger | null
Atkārtoti izmantojiet šo sākumstāvokli kopā ar nemainītu uzvedni, lai parasti atkārtotu iepriekšējo rezultātu.
model_typeneobligāts
Tipsenum
Noklusējumsstandard
standardlowpolysmart-topology
3D tīkla režīms: izvēlieties 'lowpoly', lai iegūtu zemās izšķirtspējas tīklu ar tīrākiem daudzstūriem; šajā režīmā Meshy ignorē topology, target_polycount un should_remesh. Parastam augstas detalizācijas rezultātam izvēlieties 'standard', bet 'smart-topology' izmanto Meshy-T2 ģeometrijas (preview) posmā un iegūst tīras daļas, kas jau sākotnēji ģenerētas atsevišķi.
topologyneobligāts
Tipsenum
Noklusējumstriangle
quadtriangle
Modeļa topoloģijas izvēle starp Triangle ģeometriskām detaļām un Quad virsmas gludumam.
target_polycountneobligāts
Tipsinteger
Noklusējums30000
100 – 300 000
Daudzstūru skaita mērķis; ja model_type ir 'smart-topology', tas nepārsniedz 15,000. Ja šajā režīmā mērķis nav norādīts, tiek izmantots Meshy zemākais noklusējums — 4,000.
should_remeshneobligāts
Tipsboolean
Noklusējumstrue
Izlaidiet atkārtotu tīkla izveidi un saņemiet neapstrādātu trijstūru tīklu, iestatot šo uz false; pretējā gadījumā iespējojiet atkārtotas tīkla izveides posmu.
symmetry_modeneobligāts
Tipsenum
Noklusējumsauto
offautoon
Simetrijas iestatījums, ko izmanto modeļa ģenerēšanas laikā.
enable_pbrneobligāts
Tipsboolean
Noklusējumsfalse
Nosaka metāliskuma, raupjuma un normāļu PBR karšu ģenerēšanu līdzās pamatkrāsai.
is_a_t_poseneobligāts
Tipsboolean
Noklusējumsfalse
T-pozīcijas ģenerēšanas slēdzis, ko aktivizē true; novecojis, priekšroka dodama pose_mode.
pose_modeneobligāts
Tipsenum
Noklusējums
a-poset-pose
Atstājiet virkni tukšu, lai nenorādītu ģenerētā modeļa pozu, vai pieprasiet A-pozīciju ar 'a-pose' vai T-pozīciju ar 't-pose'.
enable_prompt_expansionneobligāts
Tipsboolean
Noklusējumsfalse
Ļauj lielajam valodas modelim papildināt uzvedni ar detalizētu informāciju. Šī paplašināšana nemaina uzvednes nozīmi.
texture_promptneobligāts
Tipsstring | null
≤ 600 rakstzīmju
Vadiet teksturēšanu ar papildu teksta uzvedni 'full' režīmā; citi režīmi to neizmanto.
texture_image_urlneobligāts
Tipsurl · image
2D atsauces attēls tekstūras ģenerēšanai, kas tiek izmantots tikai 'full' režīmā.
enable_riggingneobligāts
Tipsboolean
Noklusējumsfalse
Automātiska humanoīda skeleta izveide, kas visefektīvāk darbojas humanoīdiem modeļiem ar skaidri atšķiramām ekstremitātēm. Iespējojot šo opciju, ģenerētajam modelim tiek izveidots skelets un nodrošinātas pamata iešanas un skriešanas animācijas.
rigging_height_metersneobligāts
Tipsnumber
Noklusējums1.7
> 0
Norādiet aptuveno tēla augstumu metros, ja enable_rigging ir true; pretējā gadījumā šai vērtībai nav ietekmes.
enable_animationneobligāts
Tipsboolean
Noklusējumsfalse
Vai skeletotajam modelim tiek piešķirta iepriekš iestatīta animācija; tam nepieciešams, lai enable_rigging būtu true.
animation_action_idneobligāts
Tipsinteger
Noklusējums92
Meshy bibliotēkas animācijas iepriekš iestatītais ID; pieejamās darbības uzskaitītas vietnē https://docs.meshy.ai/en/api/animation-library. Validācija un lietošana attiecas tikai tad, ja enable_animation ir true: vērtības ārpus [0, 696] tiek noraidītas ar 422, un "Idle" atbilst `0`.
enable_safety_checkerneobligāts
Tipsboolean
Noklusējumstrue
Priekšapstrādes drošības pārbaudes slēdzis: true padara ievades drošības pārbaudi par priekšnoteikumu apstrādei.
geometry_resolutionneobligāts
Tipsenum
standard2k
Tīkla ģeometrijas izšķirtspēja; atbalstītās Meshy-7 opcijas ir standard un 2k.
ultra_modeneobligāts
Tipsboolean
Noklusējumsfalse
Novecojusi opcija, ko aizstāj geometry_resolution; ja norādītas abas, priekšroka ir geometry_resolution. Izmantojiet geometry_resolution='2k'.
obligāts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
animation_glb
object {url, content_type, file_name, file_size} | nullAnimācijas rezultāts ar 3D modeli GLB formātā; atbilde šo rezultātu neietver, ja vien enable_animation nav true.
animation_fbx
object {url, content_type, file_name, file_size} | nullAnimācijas rezultāts ar 3D modeli FBX formātā; atbilde šo rezultātu neietver, ja vien enable_animation nav true.
model_glb
object {url, content_type, file_name, file_size}GLB fails ar ģenerēto 3D objektu.
thumbnail
object {url, content_type, file_name, file_size} | nullSīktēls ar ģenerētā modeļa priekšskatījumu.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Saites uz 3D modeli dažādos formātos.
texture_urls
array of object {base_color, metallic, normal, roughness}Tekstūras faili, kas attēloti kā objektu masīvs.
seed
integer | nullĢenerēšanas laikā izmantotā sēklas vērtība.
prompt
stringĢenerēšanai iesniegtā teksta uzvedne.
actual_prompt
string | nullĢenerēšanai faktiski izmantotais uzvednes teksts, ja uzvednes paplašināšana bija iespējota.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullSkeleta izveides rezultāts, kas piegādāts kā GLB tēla fails; atbildē nav iekļauts, ja vien enable_rigging nav true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullSkeleta izveides rezultāts, kas piegādāts kā FBX tēla fails; atbildē nav iekļauts, ja vien enable_rigging nav true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullPamata iešanas un skriešanas animācijas, iekļautas tikai tad, ja enable_rigging ir true.
rig_task_id
string | nullSkeleta izveides uzdevuma identifikators; iekļauts tikai tad, ja enable_rigging ir true.

Vairāk modeļu: Teksts uz 3D

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/meshy/v7/text-to-3d.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt