Mga Pagpapatanda (Deprecations)
Tingnan kung aling mga modelo ng Meshy AI at feature ng API ang aktibo, deprecated, o retired, at hanapin ang mga petsa ng pagreretiro at mga inirerekomendang kapalit.
Habang naglalabas ang Meshy ng mga bagong modelo, nagreretiro ito ng mga mas lumang modelo. Ang mga integration na umaasa sa mas lumang modelo o feature ng API ay maaaring mangailangan ng pana-panahong mga update upang patuloy na gumana. Ang pahinang ito ay naglilista ng bawat deprecation ng API, kasama ang inirerekomendang kapalit nito.
Pangkalahatang-ideya
Ginagamit ng Meshy ang mga terminong ito upang ilarawan ang lifecycle ng isang modelo o feature ng API:
- Aktibo: Lubos 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 ang Meshy ng inirerekomendang kapalit at, kapag naka-iskedyul na, isang petsa ng pagreretiro.
- Retired: Hindi na available. Ang mga request na gumagamit ng retired na modelo o feature ay nagbabalik ng error.
Ang pagreretiro ng isang modelo ay hindi nagtatanggal ng mga nagawa mo na gamit ito. Ang mga task na ginawa mo gamit ang isang retired na 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 magbigay ng ibang resulta kaysa sa modelong pinapalitan nito. Subukan ang iyong integration gamit ang kapalit nang maaga bago ang petsa ng pagreretiro, halimbawa sa Playground.
Mga Abiso
Inaanunsyo ng Meshy ang bawat deprecation at pagreretiro sa changelog at sa pahinang ito. Habang paparating na ang isang pagreretiro, ipinapakita ito ng isang banner sa itaas ng bawat pahina ng API, at minamarkahan ng mga pahina ng endpoint ang modelo o parameter bilang deprecated.
Inaanunsyo ng Meshy ang petsa ng pagreretiro nang hindi bababa sa isang buwan bago ang pagreretiro.
Mga Pinakamahusay na Kasanayan
- Suriin ang changelog at ang pahinang ito nang regular para sa mga update sa deprecation.
- Itakda ang
ai_modelsa isang tiyak na modelo, tulad ngmeshy-7.1, kung kailangan ng iyong integration ng pare-parehong output. Anglatestay laging tumutukoy sa pinakabagong standard na modelo, kaya nagbabago ang output nito kapag inilabas ang isang bagong modelo. - Subukan ang iyong integration gamit ang kapalit nang maaga bago ang petsa ng pagreretiro ng iyong kasalukuyang modelo.
- I-update ang iyong code upang gamitin ang inirerekomendang kapalit sa lalong madaling panahon.
- Makipag-ugnayan sa support@meshy.ai kung kailangan mo ng tulong sa paglipat.
Katayuan ng Modelo
Kasalukuyan at retired na 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 bawat modelo; nililista ng bawat pahina ng endpoint ang mga modelong tinatanggap nito.
| Pangalan ng modelo sa API | Kasalukuyang katayuan | Deprecated | Petsa ng pagreretiro |
|---|---|---|---|
meshy-7.1 | Aktibo | Wala | Wala |
meshy-7 | Deprecated | September 18, 2026 | Ianunsyo pa |
meshy-6 | Aktibo | Wala | Wala |
meshy-6-lite | Aktibo | Wala | Wala |
meshy-5 | Retired | September 11, 2026 | October 10, 2026 |
meshy-4 | Retired | Wala | March 20, 2026 |
meshy-3 | Retired | January 14, 2025 | July 2025 |
meshy-t2.5 | Aktibo | Wala | Wala |
meshy-t2 | Aktibo | Wala | Wala |
meshy-t1 | Deprecated | July 13, 2026 | October 30, 2026 |
model_type: "lowpoly" | Deprecated | July 13, 2026 | October 30, 2026 |
Ang latest ay nagre-resolve sa meshy-7.1.
Kasaysayan ng Pagpapatanda
Nakalista sa ibaba ang lahat ng mga deprecation, kung saan ang pinakabagong mga anunsyo ay nasa una.
| 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 | October 30, 2026 | model_type: "smart-topology" kasama ang ai_model: "meshy-t2.5" |
| 2026-09-29 | /v2/text-to-3d na walang prefix na /openapi | Ianunsyo pa | /openapi/v2/text-to-3d |
| 2026-09-18 | meshy-7 | Ianunsyo pa | meshy-7.1 |
| 2026-09-16 | Shared na API key para sa test mode | September 16, 2026 | Ang sarili mong key mula sa pahina ng API Keys, o ang Playground |
| 2026-09-11 | meshy-5 | October 10, 2026 | meshy-6-lite |
| 2026-03-20 | meshy-4 | March 20, 2026 | meshy-6 |
| 2025-10-01 | API ng Text to Voxel | October 1, 2025 | Wala |
| 2025-07-01 | API ng Text to Texture | July 1, 2025 | Retexture |
| 2025-01-14 | meshy-3 | July 2025 | meshy-6 |
Mga Pagpapatanda ng Parameter ng API
Paminsan-minsang dina-deprecate ng Meshy ang mga request parameter at response field na pinapalitan o hindi na ginagamit ng mga mas bagong modelo. Gumagana pa rin ang mga ito maliban kung nabanggit, ngunit maaaring tanggalin ang mga ito ng isang susunod na release.
| Parameter | Katayuan | Pag-uugali | Inirerekomendang kapalit |
|---|---|---|---|
texture_image_url sa Rigging | Deprecated noong October 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 ng Meshy ang mga texture ng model_url o ng input task. |
ultra_mode | Deprecated noong September 18, 2026 | Ang ultra_mode: true ay katumbas ng geometry_resolution: "2k". | geometry_resolution |
hd_texture | Deprecated noong July 21, 2026 | Ang hd_texture: true ay katumbas ng texture_resolution: "4k". Kung ipadala mo ang pareho, gagamitin ng Meshy ang texture_resolution. | texture_resolution |
| Mga parameter ng Convert at resize ng Remesh | Deprecated noong May 22, 2026 | Gumagana pa rin. | Convert at Resize |
symmetry_mode | Deprecated noong May 11, 2026 | Tinatanggap ngunit hindi pinapansin. | Alisin ito. |
art_style sa Text to 3D Preview | Deprecated noong January 22, 2026 | Tinatanggap ngunit hindi pinapansin. Inilapat lamang ito sa Meshy 4 at Meshy 5. | Alisin ito. |
is_a_t_pose | Deprecated noong December 4, 2025 | Gumagana pa rin. | pose_mode |