Deprekasi
Lihat model AI Meshy dan fitur API mana yang aktif, usang, atau dihentikan, serta temukan tanggal penghentian dan pengganti yang direkomendasikan.
Seiring Meshy merilis model baru, model lama akan dihentikan. Integrasi yang bergantung pada model atau fitur API yang lebih lama mungkin memerlukan pembaruan sesekali agar tetap berfungsi. Halaman ini mencantumkan setiap deprekasi API, beserta pengganti yang direkomendasikan.
Ikhtisar
Meshy menggunakan istilah-istilah berikut untuk menjelaskan siklus hidup suatu model atau fitur API:
- Aktif: Didukung sepenuhnya dan direkomendasikan untuk digunakan.
- Legacy: Tidak lagi menerima pembaruan dan mungkin akan usang di masa mendatang. Masih berfungsi, dan tidak ada perubahan apa pun pada permintaan atau tagihan Anda.
- Usang: Masih berfungsi, tetapi tidak lagi direkomendasikan. Meshy menyebutkan pengganti yang direkomendasikan dan, setelah dijadwalkan, tanggal penghentiannya.
- Dihentikan: Tidak lagi tersedia. Permintaan yang menggunakan model atau fitur yang sudah dihentikan akan mengembalikan error.
Menghentikan sebuah model tidak menghapus apa yang telah Anda buat dengannya. Tugas yang Anda buat dengan model yang sudah dihentikan tetap tersedia selama periode retensi yang biasa berlaku.
Migrasi ke Pengganti
Setelah sebuah model dinyatakan usang, pindahkan semua permintaan Anda ke penggantinya sebelum tanggal penghentian. Permintaan yang menggunakan model tersebut setelah tanggal itu akan gagal.
Pengganti dapat menghasilkan hasil yang berbeda dari model yang digantikannya. Uji integrasi Anda dengan pengganti tersebut jauh sebelum tanggal penghentian, misalnya di Playground.
Notifikasi
Meshy mengumumkan setiap deprekasi dan penghentian di catatan perubahan dan di halaman ini. Selama penghentian akan segera berlaku, sebuah banner di bagian atas setiap halaman API akan menampilkannya, dan halaman endpoint menandai model atau parameter tersebut sebagai usang.
Meshy mengumumkan tanggal penghentian setidaknya satu bulan sebelum penghentian dilakukan.
Praktik Terbaik
- Periksa catatan perubahan dan halaman ini secara berkala untuk pembaruan deprekasi.
- Atur
ai_modelke model tertentu, sepertimeshy-7.1, jika integrasi Anda memerlukan output yang konsisten.latestselalu mengarah ke model standar terbaru, sehingga outputnya berubah saat model baru dirilis. - Uji integrasi Anda dengan pengganti jauh sebelum tanggal penghentian model Anda saat ini.
- Perbarui kode Anda untuk menggunakan pengganti yang direkomendasikan sesegera mungkin.
- Hubungi support@meshy.ai jika Anda memerlukan bantuan dalam migrasi.
Status Model
Model generasi 3D saat ini dan yang sudah dihentikan dari Teks ke 3D, Gambar ke 3D, Multi-Gambar ke 3D, dan Retexture. Tidak semua endpoint menawarkan semua model; setiap halaman endpoint mencantumkan model yang diterimanya.
| Nama model API | Status saat ini | Diusangkan | Tanggal penghentian |
|---|---|---|---|
meshy-7.1 | Aktif | N/A | N/A |
meshy-7 | Usang | 18 September 2026 | 31 Desember 2026 (geometri); N/A (tekstur) |
meshy-6 | Aktif | N/A | N/A |
meshy-6-lite | Aktif | N/A | N/A |
meshy-n1 | Aktif | N/A | N/A |
meshy-5 | Dihentikan | 11 September 2026 | 10 Oktober 2026 |
meshy-4 | Dihentikan | N/A | 20 Maret 2026 |
meshy-3 | Dihentikan | 14 Januari 2025 | Juli 2025 |
meshy-t2.5 | Aktif | N/A | N/A |
meshy-t2 | Aktif | N/A | N/A |
meshy-t1 | Usang | 13 Juli 2026 | 30 November 2026 |
model_type: "lowpoly" | Usang | 13 Juli 2026 | 30 November 2026 |
latest diselesaikan ke meshy-7.1.
Penghentian meshy-7 mencakup penggunaannya sebagai ai_model pada tugas preview Teks ke 3D, Gambar ke 3D, dan Multi-Gambar ke 3D. meshy-7.1 menerima parameter yang sama dan biayanya juga sama. Mulai 31 Desember 2026, permintaan tersebut akan mengembalikan 400.
meshy-7 sebagai model tekstur tidak terpengaruh. Hal ini mencakup Retexture, texture_model, dan ai_model dari refine Teks ke 3D, yang hanya memilih model tekstur.
Hingga 30 November 2026, permintaan berikut masih berjalan pada model Smart Topology dengan topology segitiga dan dikenakan harga Smart Topology:
- Gambar ke 3D dengan
model_type: "smart-topology"danai_model: "meshy-t1", atau denganmodel_type: "lowpoly"danai_modeldikosongkan,latest, ataumeshy-6. Meshy mengabaikantarget_polycount,topology,image_enhancement,remove_lighting, danexperimentalpada permintaan tersebut. - Sebuah preview Teks ke 3D dengan
model_type: "lowpoly"danai_modeldikosongkan,latest,meshy-6, ataumeshy-4(yang sebenarnya sudah dihentikan,meshy-4diterima di sini hanya untuk fallback ini). Meshy mengabaikantarget_polycount,topology, danexperimentalpada permintaan tersebut.
Setiap permintaan lain untuk meshy-t1 atau lowpoly sudah mengembalikan 400. Mulai 30 November 2026, permintaan-permintaan ini juga akan mengembalikan 400.
Riwayat Deprekasi
Semua deprekasi tercantum di bawah ini, dengan pengumuman terbaru ditampilkan lebih dahulu.
| Diumumkan | Model atau fitur yang diusangkan | Tanggal penghentian | Pengganti yang direkomendasikan |
|---|---|---|---|
| 2026-10-02 | model_type: "lowpoly" dan meshy-t1 pada Teks ke 3D dan Gambar ke 3D | 30 November 2026 | model_type: "smart-topology" dengan ai_model: "meshy-t2.5" |
| 2026-09-29 | /v2/text-to-3d tanpa prefiks /openapi | Akan diumumkan | /openapi/v2/text-to-3d |
| 2026-09-18 | meshy-7 sebagai ai_model pada preview Teks ke 3D, Gambar ke 3D, dan Multi-Gambar ke 3D | 31 Desember 2026 | meshy-7.1 |
| 2026-09-16 | Kunci API mode uji bersama | 16 September 2026 | Kunci Anda sendiri dari halaman Kunci API, atau Playground |
| 2026-09-11 | meshy-5 | 10 Oktober 2026 | meshy-6-lite |
| 2026-03-20 | meshy-4 | 20 Maret 2026 | meshy-6 |
| 2025-10-01 | API Teks ke Voxel | 1 Oktober 2025 | Tidak ada |
| 2025-07-01 | API Teks ke Tekstur | 1 Juli 2025 | Retexture |
| 2025-01-14 | meshy-3 | Juli 2025 | meshy-6 |
Deprekasi Parameter API
Meshy terkadang mengusangkan parameter permintaan dan kolom respons yang digantikan atau tidak lagi digunakan oleh model yang lebih baru. Parameter tersebut tetap berfungsi kecuali disebutkan lain, tetapi rilis mendatang dapat menghapusnya.
| Parameter | Status | Perilaku | Pengganti yang direkomendasikan |
|---|---|---|---|
texture_image_url pada Rigging | Diusangkan 23 Oktober 2026 | Masih berfungsi. Gambar tersebut menjadi satu-satunya tekstur model yang di-rig, dan model kehilangan peta PBR-nya. | Hilangkan parameter ini. Meshy menggunakan tekstur dari model_url atau dari tugas input. |
ultra_mode | Diusangkan 18 September 2026 | ultra_mode: true sama dengan geometry_resolution: "2k". | geometry_resolution |
hd_texture | Diusangkan 21 Juli 2026 | hd_texture: true sama dengan texture_resolution: "4k". Jika Anda mengirim keduanya, Meshy menggunakan texture_resolution. | texture_resolution |
| Parameter Convert dan resize pada Remesh | Diusangkan 22 Mei 2026 | Masih berfungsi. | Convert dan Ubah ukuran |
symmetry_mode | Diusangkan 11 Mei 2026 | Diterima dan diabaikan. | Hilangkan parameter ini. |
art_style pada Text to 3D Preview | Diusangkan 22 Januari 2026 | Diterima dan diabaikan. Parameter ini hanya berlaku untuk Meshy 4 dan Meshy 5. | Hilangkan parameter ini. |
is_a_t_pose | Diusangkan 4 Desember 2025 | Masih berfungsi. | pose_mode |