Mga Deprecation
Tingnan kung aling mga modelo ng Meshy AI at feature ng API ang aktibo, deprecated, o retirado, at hanapin ang mga petsa ng pagreretiro at mga inirerekomendang kapalit.
Habang naglalabas si Meshy ng mga bagong modelo, nireretiro nito ang mga lumang modelo. Ang mga integrasyong umaasa sa mas lumang modelo o feature ng API ay maaaring magkailangan ng paminsan-minsang update para patuloy na gumana. Inilista ng pahinang ito ang bawat deprecation ng API, kasama ang inirerekomendang kapalit nito.
Pangkalahatang-ideya
Ginagamit ni Meshy ang mga terminong ito upang ilarawan ang lifecycle ng isang modelo o feature ng API:
- Aktibo: Ganap na suportado at inirerekomenda para gamitin.
- Legacy: Hindi na tumatanggap ng mga update at maaaring i-deprecate sa hinaharap. Gumagana pa rin ito, at walang nagbabago sa iyong request o sa iyong bill.
- Deprecated: Gumagana pa rin, ngunit hindi na inirerekomenda. Nagtatakda si Meshy ng inirerekomendang kapalit at, kapag naiiskedyul na, ng petsa ng pagreretiro.
- Retirado: Hindi na available. Ang mga request na gumagamit ng retiradong modelo o feature ay nagbabalik ng error.
Ang pagreretiro ng isang modelo ay hindi nagbubura sa mga nagawa mo na gamit ito. Ang mga task na ginawa mo gamit ang isang retiradong modelo ay mananatiling available sa karaniwang retention period.
Paglipat sa mga Kapalit
Kapag na-deprecate na ang isang modelo, ilipat ang lahat ng iyong mga request sa kapalit nito bago ang petsa ng pagreretiro. Ang mga request na gumagamit ng modelo pagkatapos ng petsang iyon ay mabibigo.
Ang isang kapalit ay maaaring magbunga ng ibang resulta kaysa sa modelong pinapalitan nito. Subukan ang iyong integrasyon gamit ang kapalit nang maaga bago ang petsa ng pagreretiro, halimbawa sa Playground.
Mga Abiso
Inaanunsyo ni Meshy ang bawat deprecation at pagreretiro sa changelog at sa pahinang ito. Habang paparating ang isang pagreretiro, nagpapakita ng banner sa itaas ng bawat pahina ng API, at minamarkahan ng mga pahina ng endpoint ang modelo o parameter bilang deprecated.
Inaanunsyo ni Meshy ang petsa ng pagreretiro nang hindi bababa sa isang buwan bago ang pagreretiro.
Mga Pinakamahusay na Kasanayan
- Regular na tingnan ang changelog at ang pahinang ito para sa mga update sa deprecation.
- Itakda ang
ai_modelsa isang partikular na modelo, tulad ngmeshy-7.1, kung kailangan ng iyong integrasyon ng pare-parehong output. Anglatestay palaging tumutukoy sa pinakabagong standard na modelo, kaya nagbabago ang output nito kapag may bagong modelong inilabas. - Subukan ang iyong integrasyon gamit ang kapalit nang maaga bago ang petsa ng pagreretiro ng iyong kasalukuyang modelo.
- I-update ang iyong code para gamitin ang inirerekomendang kapalit sa lalong madaling panahon.
- Makipag-ugnayan sa support@meshy.ai kung kailangan mo ng tulong sa paglipat.
Status ng Modelo
Kasalukuyan at retiradong mga modelo ng 3D generation ng Text to 3D, Image to 3D, Multi-Image to 3D, at Retexture. Hindi lahat ng endpoint ay nag-aalok ng lahat ng modelo; inilista ng bawat pahina ng endpoint ang mga modelong tinatanggap nito.
| Pangalan ng modelo ng API | Kasalukuyang estado | Deprecated | Petsa ng pagreretiro |
|---|---|---|---|
meshy-7.1 | Aktibo | N/A | N/A |
meshy-7 | Deprecated | Setyembre 18, 2026 | Disyembre 31, 2026 (heometriya); N/A (texture) |
meshy-6 | Aktibo | N/A | N/A |
meshy-6-lite | Aktibo | N/A | N/A |
meshy-n1 | Aktibo | N/A | N/A |
meshy-5 | Retirado | Setyembre 11, 2026 | Oktubre 10, 2026 |
meshy-4 | Retirado | N/A | Marso 20, 2026 |
meshy-3 | Retirado | Enero 14, 2025 | Hulyo 2025 |
meshy-t2.5 | Aktibo | N/A | N/A |
meshy-t2 | Aktibo | N/A | N/A |
meshy-t1 | Deprecated | Hulyo 13, 2026 | Nobyembre 30, 2026 |
model_type: "lowpoly" | Deprecated | Hulyo 13, 2026 | Nobyembre 30, 2026 |
Ang latest ay nagre-resolve sa meshy-7.1.
Sinasaklaw ng pagreretiro ng meshy-7 ito bilang ai_model ng mga preview task ng Text to 3D, Image to 3D, at Multi-Image to 3D. Tumatanggap ng parehong mga parameter ang meshy-7.1 at nagkakahalaga ng pareho. Simula Disyembre 31, 2026, ang mga request na iyon ay magbabalik ng 400.
Ang meshy-7 bilang isang texture model ay hindi apektado. Sinasaklaw nito ang Retexture, texture_model, at ang ai_model ng isang Text to 3D refine, na pumipili lamang ng texture model.
Hanggang Nobyembre 30, 2026, ang mga request na ito ay tumatakbo pa rin sa isang modelong Smart Topology na may tatsulok na topology at nagkakahalaga ng presyo ng Smart Topology:
- Image to 3D na may
model_type: "smart-topology"atai_model: "meshy-t1", o maymodel_type: "lowpoly"at walangai_model,latest, omeshy-6. Binabalewala ni Meshy angtarget_polycount,topology,image_enhancement,remove_lighting, atexperimentalsa mga ito. - Isang preview ng Text to 3D na may
model_type: "lowpoly"at walangai_model,latest,meshy-6, omeshy-4(sa ibang pagkakataon ay retirado, tinatanggap lamang angmeshy-4dito para sa fallback na ito). Binabalewala ni Meshy angtarget_polycount,topology, atexperimentaldito.
Ang bawat ibang request para sa meshy-t1 o lowpoly ay nagbabalik na ng 400. Simula Nobyembre 30, 2026, magbabalik din ng 400 ang mga ito.
Kasaysayan ng Deprecation
Nakalista sa ibaba ang lahat ng mga deprecation, kasama ang pinakabagong mga anunsyo muna.
| Inanunsyo | Deprecated na modelo o feature | Petsa ng pagreretiro | Inirerekomendang kapalit |
|---|---|---|---|
| 2026-10-02 | model_type: "lowpoly" at meshy-t1 sa Text to 3D at Image to 3D | Nobyembre 30, 2026 | model_type: "smart-topology" na may ai_model: "meshy-t2.5" |
| 2026-09-29 | /v2/text-to-3d nang walang prefix na /openapi | Iaanunsyo pa | /openapi/v2/text-to-3d |
| 2026-09-18 | meshy-7 bilang ai_model ng preview ng Text to 3D, Image to 3D, at Multi-Image to 3D | Disyembre 31, 2026 | meshy-7.1 |
| 2026-09-16 | Shared na API key para sa test mode | Setyembre 16, 2026 | Ang sarili mong key mula sa pahina ng API Keys, o ang Playground |
| 2026-09-11 | meshy-5 | Oktubre 10, 2026 | meshy-6-lite |
| 2026-03-20 | meshy-4 | Marso 20, 2026 | meshy-6 |
| 2025-10-01 | Text to Voxel API | Oktubre 1, 2025 | Wala |
| 2025-07-01 | Text to Texture API | Hulyo 1, 2025 | Retexture |
| 2025-01-14 | meshy-3 | Hulyo 2025 | meshy-6 |
Mga Pag-deprecate ng API Parameter
Paminsan-minsang ni-deprecate ni Meshy ang mga request parameter at response field na pinapalitan o hindi na ginagamit ng mas bagong mga modelo. Gumagana pa rin ang mga ito maliban kung may nakasaad, ngunit maaari itong alisin ng isang susunod na release.
| Parameter | Status | Pag-uugali | Inirerekomendang kapalit |
|---|---|---|---|
texture_image_url sa Rigging | Deprecated noong Oktubre 23, 2026 | Gumagana pa rin. Ang larawan ay nagiging tanging texture ng na-rig na modelo, at nawawala sa modelo ang mga PBR maps nito. | Alisin ito. Ginagamit ni Meshy ang mga texture ng model_url o ng input task. |
ultra_mode | Deprecated noong Setyembre 18, 2026 | Ang ultra_mode: true ay pareho ng geometry_resolution: "2k". | geometry_resolution |
hd_texture | Deprecated noong Hulyo 21, 2026 | Ang hd_texture: true ay pareho ng texture_resolution: "4k". Kung ipapadala mo ang pareho, ginagamit ni Meshy ang texture_resolution. | texture_resolution |
| Mga parameter ng Convert at resize ng Remesh | Deprecated noong Mayo 22, 2026 | Gumagana pa rin. | Convert at Resize |
symmetry_mode | Deprecated noong Mayo 11, 2026 | Tinatanggap at binabalewala. | Alisin ito. |
art_style sa Text to 3D Preview | Deprecated noong Enero 22, 2026 | Tinatanggap at binabalewala. Naaangkop lamang ito sa Meshy 4 at Meshy 5. | Alisin ito. |
is_a_t_pose | Deprecated noong Disyembre 4, 2025 | Gumagana pa rin. | pose_mode |