Log Perubahan

Lihat semua ciri dan kemas kini terkini untuk Meshy API dan plugin.

Lebih suka suapan langsung? Entri terkini juga dipaparkan pada halaman gambaran keseluruhan Developer Platform.

Oktober 2026

`Oct 14`

model_url kini menerima fail sehingga 400 MB, naik daripada 100 MB, apabila ia merupakan URL http atau https, pada Retekstur, Remesh, Rigging, Tukar, Ubah saiz, UV Unwrap, Multi-Color Print, Analisis kebolehcetakan dan Baiki kebolehcetakan. URI data: kekal pada 100 MB. Fail GLB, glTF, FBX atau OBJ yang melebihi 100 MB boleh mempunyai paling banyak 10,000,000 muka, dikira sebagai segi tiga (8,000,000 untuk Multi-Color Print); fail dengan lebih daripada itu akan mengembalikan 400. Melebihi 100 MB, fail FBX mestilah FBX binari 7.1 atau lebih baharu, dan fail GLB atau glTF tidak boleh menggunakan mampatan Draco. Fail tersebut dimuat turun sebelum permintaan cipta dikembalikan, jadi berikan masa sehingga 120 saat untuk fail yang besar (lihat Task Lifecycle). Fail berukuran 100 MB atau kurang berfungsi seperti sebelumnya, dan harga tidak berubah.
Analisis kebolehcetakan kini membalas input_task_id yang dimiliki oleh akaun lain dengan 404 dan badan yang sama seperti id yang tidak wujud, bukannya 403. Tugas milik anda, atau milik rakan sepasukan dalam ruang kerja yang anda sertai, berfungsi seperti sebelumnya.

`Oct 12`

Fail USDZ kini menggunakan meter, jadi model dibuka pada saiz sebenarnya dalam AR Quick Look, Reality Composer, Blender dan penonton USD lain. Fail usdz dalam model_urls bagi tugas Teks ke 3D, Imej ke 3D, Berbilang Imej ke 3D, Retekstur, Remesh, Tukar, Ubah saiz dan Auto Split kini mengisytiharkan metersPerUnit = 1. Sehingga kini ia mengisytiharkan kaki (metersPerUnit = 0.3048) sedangkan koordinatnya dalam meter, jadi model dipaparkan pada 30.48% daripada saiz sebenarnya. Jika anda menskalakan fail USDZ sebanyak 3.28 untuk mengimbangi, buang penskalaan tersebut untuk tugas yang dicipta bermula dari tarikh ini. Fail bagi tugas terdahulu mengekalkan unit semasanya, dan fail USDZ Rigging serta Animasi tidak terjejas.

`Oct 10`

meshy-5 telah dihentikan. Permintaan yang menghantar ai_model: "meshy-5" ke Text to 3D, Image to 3D, Multi-Image to 3D atau Retexture kini mengembalikan 400 dengan mesej ai_model meshy-5 has been retired; use meshy-6-lite. Tukar kepada meshy-6-lite, yang menggunakan parameter yang sama pada kos credit yang sama. Model yang telah anda jana menggunakan meshy-5 masih tersedia, dan proses refine bagi pratonton meshy-5 tanpa menetapkan ai_model masih berfungsi.
.webp kini didokumentasikan sebagai format input imej yang disokong, bersama-sama .jpg, .jpeg dan .png, pada Image to 3D, Multi-Image to 3D, Image to Image, Retexture (image_style_url) dan Text to 3D Refine (texture_image_url). Ia berfungsi untuk kedua-dua URL awam dan data URI (data:image/webp;base64,...). Integrasi sedia ada tidak terjejas, dan harga tidak berubah.
Get Balance kini turut mengembalikan monthly_credits, permanent_credits dan monthly_resets_at, supaya anda dapat melihat berapa banyak baki anda yang akan tamat tempoh pada penyegaran seterusnya. balance itu sendiri tidak berubah.

`Oct 6`

Analisis kebolehcetakan dan Baiki kebolehcetakan kini boleh memeriksa ketebalan dinding pada saiz yang anda rancang untuk mencetak. Hantar printer_type, saiz cetakan, atau kedua-duanya: analisis melaporkan dinding nipis dalam printability.thin_walls, dan pembaikan menebalkannya apabila perlu, serta boleh menggunakan semula pencetak dan saiz tugasan analisis yang dihantar sebagai input_task_id. Integrasi yang tidak menggunakan medan ini berkelakuan seperti sebelumnya, dan harga tidak berubah.

September 2026

`Sep 29`

Laluan lapuk /v2/text-to-3d (tanpa awalan /openapi) adalah lapuk. Ia terus berfungsi tanpa perubahan buat masa ini, tetapi akan dialih keluar dalam keluaran akan datang — tukar ke /openapi/v2/text-to-3d, yang menerima permintaan yang sama dan mengembalikan respons yang sama. Respons pada laluan lapuk kini membawa header Deprecation dan header Link yang menunjuk ke laluan baharu.

`Sep 28`

Respons API kini merangkumi header had kadar, termasuk Retry-After untuk memberitahu anda berapa lama perlu menunggu sebelum mencuba semula atau mengundi semula.
Multi-Color Print menerima parameter baharu printer_brand yang menulis praset slicer yang sepadan ke dalam 3MF, supaya fail dibuka sedia untuk mencetak pada pencetak Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker dan AnkerMake serta Bambu Lab (lalai). Halaman ini kini turut mendokumenkan max_depth.

`Sep 18`

Menambah meshy-7.1 sebagai nilai ai_model untuk Imej ke 3D, Berbilang Imej ke 3D dan Teks ke 3D: parameter dan kos kredit yang sama seperti meshy-7, perincian geometri yang lebih tinggi. latest kini menghala kepada meshy-7.1; meshy-7 telah lapuk tetapi masih berfungsi tanpa perubahan.
Menambah geometry_resolution (standard / 2k / 4k) kepada API yang sama, menggantikan ultra_mode yang kini lapuk (ultra_mode: true masih berfungsi dan bersamaan dengan "2k"). 4k memerlukan Meshy 7.1 (meshy-7.1 atau latest), tidak tersedia pada Berbilang Imej ke 3D, dan berkos sama seperti 5 kredit tambahan seperti 2k.

`Sep 16`

API Auto Split kini menerima input_task_id yang bertekstur. Sebelum ini ia menolak permintaan tersebut dengan 400, yang bermakna anda terpaksa menjana jejaring yang sama buat kali kedua dengan should_texture: false hanya untuk memisahkannya. Ambil perhatian apa yang dikembalikan oleh pemisahan: ia memotong geometri dan membina semula permukaan setiap bahagian, jadi tekstur input tidak dibawa bersama dan hasilnya ialah model tanpa tekstur dengan satu warna rata bagi setiap bahagian — ini sudah pun berlaku bagi setiap pemisahan dan tidak berubah.
meshy-5 akan dipersarakan pada 10 Oktober 2026. Ia tidak lagi didokumenkan sebagai nilai ai_model untuk Teks ke 3D, Imej ke 3D, Berbilang Imej ke 3D atau Retekstur, dan selepas 10 Oktober, permintaan yang menghantar ai_model: "meshy-5" akan mengembalikan ralat.
Kunci API mod ujian yang dikongsi telah dipersarakan; permintaan yang masih menghantarnya kini mengembalikan 401 Unauthorized. Jika anda telah menyalinnya ke dalam kod atau CI, gantikannya dengan kunci anda sendiri daripada laman Kunci API. Kunci tersebut sentiasa mengembalikan model sampel yang sama tanpa mengira input, jadi ia tidak pernah menunjukkan apa yang sebenarnya akan dijana oleh sesuatu permintaan. Untuk melihat apa yang dikembalikan oleh API sebelum membina sesuatu berdasarkannya, gunakan Playground dalam Developer Platform, yang menjalankan tugas sebenar dalam pelayar anda. Pada pelan tanpa akses API, ia menjalankan Imej ke 3D tanpa kunci API dan menggunakan kredit akaun anda seperti mana-mana tugas lain.

`Sep 15`

Menambahkan gpt-image-2-5-flare dan gpt-image-2-5-sunburst ke dalam nilai ai_model yang didokumentasikan untuk API Teks ke Imej dan Imej ke Imej. Ini merupakan peringkat OpenAI GPT Image 2.5, dengan harga yang sama seperti gpt-image-2 (Teks ke Imej: 9 kredit; Imej ke Imej: 12 kredit).
Model GPT Image (gpt-image-2, gpt-image-2-5-flare, gpt-image-2-5-sunburst) kini turut menerima nisbah bidang 4:3 dan 3:4 pada API Teks ke Imej dan Imej ke Imej, selain daripada 1:1, 16:9, 9:16, 3:2, dan 2:3.

`Sep 14`

API Imej ke Imej kini menerima input_task_id — rantai terus daripada tugas Teks ke Imej atau Imej ke Imej yang telah selesai, tanpa perlu menyalin URL outputnya ke dalam reference_image_urls.

`Sep 11`

Perubahan tingkah laku: DELETE pada tugas yang sudah pun IN_PROGRESS kini ditolak dengan 409 Conflict, dan tugas tersebut dibiarkan terus berjalan. Sebelum ini, ia mengembalikan 200 OK, menghentikan pekerja dan membuang hasilnya — sambil tetap mengekalkan kredit, kerana hanya tugas PENDING yang boleh dikembalikan kreditnya, jadi panggilan tersebut membebankan anda dengan kos model dan kredit tanpa sebarang petunjuk dalam respons tentang perkara ini. Jika integrasi anda memadam tugas untuk membatalkannya, ambil perhatian bahawa tugas yang pekerja sudah mula jalankan tidak boleh dibatalkan: tunggu sehingga SUCCEEDED, FAILED atau CANCELED, kemudian padamkannya. Tugas PENDING masih dipadam dan dikembalikan kreditnya seperti sebelum ini, dan tugas yang sudah terminal juga tetap dipadam. Berkuat kuasa untuk setiap keluarga tugas di bawah /openapi. Lihat Ralat.
Menambah meshy-6-lite ke dalam nilai ai_model yang didokumenkan untuk API Teks ke 3D, Imej ke 3D, Berbilang Imej ke 3D dan Retekstur. Ia adalah pengganti kepada meshy-5: parameter yang sama, kos kredit yang sama (5 untuk jejaring, 15 dengan tekstur, 10 untuk retekstur).
meshy-5 kini lapuk di semua API yang menerimanya. Ia terus berfungsi dan tiada apa-apa yang berubah pada permintaan atau bil anda, tetapi ia akan berhenti menerima trafik baharu pada keluaran akan datang — jika integrasi anda menghantar ai_model: "meshy-5", migrasikan ke meshy-6-lite.

`Sep 9`

Auto Split API baharu: Pisahkan model Meshy 6 atau Meshy 7 yang tidak bertekstur kepada bahagian yang boleh dicetak secara berasingan — secara automatik, mengikut bahagian yang anda namakan (by_parts), atau mengikut kawasan warna (by_color) — dengan penyambung mortise-and-tenon pilihan dan pengukuhan dinding nipis. Mengeksport setiap bahagian sebagai objek tersendiri dalam glb, obj, fbx, usdz, blend, atau 3mf, sama ada tersusun bersama atau diletakkan di atas plat binaan (layout). 10 kredit setiap tugas.

`Sep 7`

Menambah parameter name_text pada peringkat prototaip Creative Lab Keychain API: ukir nama sehingga 10 aksara pada rantai kunci, sama seperti pemperibadian yang ditawarkan oleh aplikasi web. Peringkat pembinaan akan mewarisi ukiran tersebut secara automatik, dan objek tugas prototaip kini mengembalikan name_text supaya anda dapat mengesahkan teks yang tepat sebelum membina. Perhatikan bahawa name kekal sebagai label tugas untuk paparan sahaja dan tidak diukir.

`5 Sep`

Menambahkan API Creative Lab Fidget Pixel: menukar sekeping foto kepada papan fidget seni piksel pelbagai warna yang boleh dicetak dalam 3D melalui dua peringkat. POST /prototype (6 kredit) menukar foto kepada imej seni piksel — hantar type sebagai person atau other untuk memilih gaya pemikselan — dan POST /build (30 kredit) membuat sampel imej tersebut ke atas grid 16 atau 32 serta menukar setiap piksel menjadi kepingan square atau hex yang saling berkunci, dihantar sebagai satu fail 3MF bertanda warna untuk percetakan pelbagai filamen. Geometri kepingan boleh dilaraskan melalui piece_size_mm, color_count, dan piece_height_mm.

`Sep 4`

Menambahkan GET /openapi/v1/animations/library ke dalam Pustaka animasi: dapatkan semua tindakan prapasang yang diterima oleh Animation API — action_id, nama, kategori, dan pratonton GIF beranimasi — dengan penapis carian dan kategori, supaya anda boleh membina pemilih tindakan anda sendiri dan bukannya membaca jadual rujukan. Percuma; tidak menggunakan sebarang kredit.
Menambahkan Creative Lab Collapsible Fidget API: ubah foto menjadi mainan fidget boleh lipat yang dicetak secara terus (print-in-place), di mana siluet subjek menjadi gelang-gelang konsentrik bersarang yang boleh dilipat rata dan direntang semula, dicetak dalam satu bahagian tanpa pemasangan. Satu POST sahaja membawa imej tersebut hingga ke model siap — tiada pasangan peringkat prototaip/bina dan tiada parameter geometri untuk diselaraskan. Setiap tugas berharga 6 kredit dan mengembalikan kedua-dua fail STL yang boleh dicetak serta fail GLB untuk pratonton.

`Sep 3`

Peringkat prototaip API Lampu Creative Lab kini mengembalikan model 3D: POST /prototype menukar imej konsep kepada GLB penudung lampu yang berongga, dan objek tugasan prototaip memperoleh model_urls.glb dan thumbnail_url di samping image_urls. Peringkat build hanya menjalankan pemproses lampu pada model tersebut dan kini menghasilkan penudung lampu berdasar terbuka dengan plat tapak untuk kelengkapan sumber cahaya. Harga turut berubah mengikut kerja yang dilakukan: prototaip ialah 30 kredit dan build 6 kredit (sebelum ini 6 dan 30). Parameter text untuk prototaip telah dibuang — image_url kini diperlukan.

`Sep 2`

API Animasi kini menerima action_ids — gunakan sehingga 10 aksi praset pada satu watak yang telah dirig dalam satu permintaan dan terima satu fail yang mengandungi satu klip animasi bagi setiap aksi, sedia untuk dipacu daripada mesin keadaan dalam enjin permainan. Klip mengekalkan susunan yang anda senaraikan dan membawa nama pustaka animasi tersebut. Dikenakan 3 kredit bagi setiap aksi, dan post_process dikenakan pada fail yang digabungkan. Lihat Rujukan Pustaka animasi untuk id yang tersedia dan jadual harga.

`Sep 1`

Menambahkan parameter ultra_mode pada Multi-Image to 3D API: membolehkan penjanaan Ultra pada ai_model meshy-7 (atau latest) untuk geometri dengan kesetiaan lebih tinggi dan perincian permukaan yang lebih halus, dengan tambahan 5 kredit — laluan Ultra yang sama seperti yang ditawarkan oleh Image to 3D API, kini tersedia dengan input berbilang pandangan.
Mengeluarkan meshy-t1 daripada nilai ai_model yang didokumenkan untuk model_type Smart Topology pada Image to 3D API. Smart Topology kini hanya mendokumenkan meshy-t2; integrasi baharu harus menggunakannya sebagai ganti. Meshy T1 dirancang untuk dinyahtauliah (deprecated) — jika integrasi anda kini menghantar ai_model: "meshy-t1", migrasikan kepada meshy-t2.

Ogos 2026

`Aug 28`

Menambahkan Usage API untuk pasukan Studio dan Enterprise: eksport secara programatik sejarah penggunaan tugas API — endpoint, status, cap masa, kunci API yang menjalankan setiap tugas, dan consumed_credits — dengan penomboran halaman standard serta penapis tetingkap masa, endpoint, dan status, untuk penjejakan kos dan sistem kewangan.

`Aug 26`

Animation API kini menerima motion_task_id — gunakan klip gerakan yang dijana dengan Text to Motion API pada watak biped berigkan anda, sebagai alternatif kepada action_id prasetel. Kredit yang sama iaitu 3 kredit setiap tugas.

`Aug 24`

Menambah sokongan aspect_ratio untuk gpt-image-2 pada API Teks ke Imej dan Imej ke Imej untuk menambahkan 16:9 dan 9:16. gpt-image-2 kini menerima 1:1, 16:9, 9:16, 3:2, dan 2:3; 4:3 dan 3:4 masih tidak disokong untuk model ini.

`Aug 21`

Menambah Text to Motion API: menjana klip gerakan watak daripada penerangan bahasa semula jadi, tanpa memerlukan model watak. Pilih mode prime (10 kredit, output FBX) untuk kualiti tertinggi atau mode swift (3 kredit, output BVH) untuk penjanaan yang pantas dan menjimatkan, dengan tempoh klip 2–10 saat.

`Aug 20`

Menambah parameter style pada Multi-Color Print API: pilih realistic (lalai) untuk warna yang tepat mengikut tekstur, atau cartoon untuk kawasan warna rata dan seragam serta 3MF yang lebih kecil.
Menambah parameter remove_background pada setiap endpoint prototaip Creative Lab — Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet dan Lamp. Tetapkan remove_background: true untuk menerima imej prototaip sebagai PNG RGBA telus dengan latar belakang dialih keluar.

`18 Ogos`

Menambah parameter texture_image_urls pada API Berbilang Imej ke 3D: sediakan 1–4 imej objek yang sama untuk memandu pembuatan texture, menggantikan texture_image_url yang tunggal. Memerlukan ai_model meshy-7 atau latest, dan tidak bergantung kepada image_urls — kedua-dua senarai boleh mengandungi imej yang berbeza dan bilangan imej yang berbeza.

`17 Ogos`

Menambah parameter remove_background pada API Teks ke Imej dan API Imej ke Imej. Tetapkan remove_background: true untuk menerima imej yang dijana sebagai PNG RGBA lutsinar dengan latar belakang dibuang.

`Aug 13`

Menambahkan ai_model: "meshy-7" pada API Teks ke 3D: model penjanaan 3D terbaharu kami, dengan geometri berketepatan lebih tinggi berbanding Meshy 6. Ia juga memperkenalkan parameter ultra_mode pada tugas preview, yang membolehkan penjanaan Ultra untuk perincian permukaan yang lebih halus dengan tambahan 5 kredit. Untuk mentekstur dengan Meshy 7, hantar ai_model: "meshy-7" pada tugas refine atau abaikan ai_model sepenuhnya.
Menambahkan model_type Smart Topology pada API Teks ke 3D. Tetapkan model_type: "smart-topology" untuk menjana dengan meshy-t2 — topology yang lebih bersih, bahagian yang dipisahkan secara semula jadi, output segi tiga, dan bilangan muka yang boleh anda tetapkan dengan target_polycount (100 hingga 15,000, lalai 4,000). Satu preview Smart Topology memerlukan 5 kredit berbanding 20; lihat Harga. model_type: "lowpoly" yang sedia ada kini lapuk tetapi terus beroperasi untuk trafik demi keserasian ke belakang.

`Aug 12`

Menambahkan ai_model: "meshy-7" pada API Imej ke 3D: model penjanaan 3D terbaharu kami, dengan geometri berketepatan lebih tinggi berbanding Meshy 6. Ia juga memperkenalkan parameter ultra_mode, yang membolehkan penjanaan Ultra untuk perincian permukaan yang lebih halus.
Menambahkan ai_model: "meshy-7" pada API Berbilang Imej ke 3D: model penjanaan berbilang pandangan Meshy, yang bergantung kepada semua pandangan input anda secara bersama dan mendorong teksturan daripadanya.
Menambahkan ai_model: "meshy-7" pada API Retekstur: model teksturan terbaharu kami, dengan perincian permukaan yang lebih tajam dan bahan PBR yang lebih bersih berbanding Meshy 6. Ia juga memperkenalkan parameter multiview_image_urls — berikan 1–4 pandangan tersusun bagi objek yang sama untuk mendorong teksturan berbilang pandangan.

`Aug 4`

Memperluaskan sokongan input model_url kepada .glb, .gltf, .obj, .fbx, .stl untuk endpoint Analisis kebolehcetakan dan Baiki kebolehcetakan (sebelum ini .glb, .stl, .obj). Baiki kebolehcetakan mengembalikan aset yang dibaiki dalam format inputnya.

Julai 2026

`Jul 27`

Baharu Creative Lab — Brick Figure API: tukar foto kepada minifigur 3D koleksi bergaya bata. Aliran kerja dua peringkat yang sama seperti Figure API — prototype (6 kredit) menjana imej konsep bergaya, build (30 kredit) menukarnya menjadi model 3D bertekstur dengan output GLB dan OBJ + MTL. Lihat Harga untuk pecahan lengkap.

`Jul 22`

Baharu Creative Lab — Keycap API: menukar foto kepada keycap papan kekunci mekanikal tersuai bersaiz penuh warna. Aliran kerja dua peringkat — prototype (12 kredit) menjana rendering reka bentuk keycap yang telah siap, kemudian build (50 kredit) menukar reka bentuk yang anda pilih (melalui candidate_id) kepada model keycap 3D bertekstur dengan output pakej GLB dan OBJ, dieksport pada skala milimeter dunia sebenar. Pada masa ini menyokong asas standard Cherry MX 1u (cherry-mx-1x1-r1); lebih banyak saiz standard dirancang. Lihat Harga untuk pecahan penuh.

`Jul 21`

Kini kami menyokong tekstur warna asas 8K melalui parameter texture_resolution baharu (2k / 4k / 8k) pada endpoint Image to 3D, Multi-Image to 3D, Text to 3D Refine, dan Retexture. Pada 8k, peta PBR dijana pada 4K dan tiada peta emisi dihasilkan. Penjanaan tekstur 8K memerlukan 15 kredit (2k/4k kekal 10). Lihat Pricing.
Boolean hd_texture adalah lapuk dan digantikan dengan texture_resolution — ia masih disokong dan setara dengan texture_resolution: "4k" demi keserasian ke belakang.

`Jul 20`

Baharu Creative Lab — Vinyl Figure API: tukar foto kepada figura koleksi vinyl berkepala besar dalam bentuk 3D. Aliran kerja dua peringkat yang sama seperti Figure API — prototype (6 kredit) menjana imej konsep bergaya, build (30 kredit) menukarnya menjadi model 3D bertekstur dengan output GLB dan OBJ + MTL. Lihat Harga untuk pecahan penuh.

`Jul 13`

Menambah model_type Smart Topology baharu pada API Imej ke 3D, menawarkan dua model melalui ai_model: meshy-t1 — model low-poly semasa — dan meshy-t2 — model baharu dengan topology yang lebih kemas, bahagian yang dipisahkan secara asli, output segi tiga, dan bilangan muka yang boleh anda tetapkan dengan target_polycount. meshy-t2 adalah lalai di bawah smart-topology. model_type: lowpoly yang sedia ada kini telah lapuk tetapi terus beroperasi untuk keserasian ke belakang.

`Jul 7`

Menambahkan parameter aspect_ratio kepada API Imej ke Imej, supaya anda boleh mengawal nisbah imej output semasa menyunting. Nilai yang dibenarkan ialah 1:1, 16:9, 9:16, 4:3, 3:4 untuk model nano-banana dan 1:1, 3:2, 2:3 untuk gpt-image-2. Pilihan tambahan; lalai kepada 1:1, dan tidak boleh digabungkan dengan generate_multi_view.

June 2026

`Jun 17`

Halaman dokumentasi baharu API Playground: satu konsol interaktif untuk mencuba endpoint tanpa menulis kod, kemudian menyalin kod cURL, Python, atau JavaScript yang setara. Tersedia pada pelan Pro, Premium, Ultra, Studio, dan Enterprise.

`Jun 15`

API UV Unwrap baharu: menjana susun atur UV berkualiti tinggi untuk model 3D sedia ada — langkah prasyarat sebelum pengteksturan, atau bila-bila masa anda memerlukan susun atur UV yang bersih dan tidak bertindih untuk alat hiliran. Menerima sama ada input_task_id (tugasan Imej ke 3D, Teks ke 3D, atau Remesh yang telah selesai) atau model_url (.glb sahaja) dan mengembalikan "model putih UV" dengan koordinat UV yang baharu. 5 kredit setiap panggilan. Menyokong mesh sehingga 40,000 muka (jalankan Remesh dahulu jika lebih besar); mesh kuad dan n-gon ditriangulasi semasa penjanaan UV.

`Jun 12`

Mengemas kini harga Build Creative Lab API kepada 30 kredit setiap panggilan untuk Keychain, Fridge Magnet, dan Figure (sebelum ini 20). Lamp tidak berubah pada 30 kredit. Harga Prototype tidak berubah pada 6 kredit setiap imej. Lihat Pricing untuk pecahan penuh.

`Jun 5`

Menambah parameter pilihan alpha_thumbnail pada API Image to 3D, Multi-Image to 3D, Text to 3D, Retexture, Remesh, dan Repair Printability. Apabila ditetapkan kepada true, tugas tersebut juga akan menghasilkan versi pratonton berlatar belakang lutsinar (RGBA) dan mengembalikannya di bawah medan respons baharu alpha_thumbnail_url. thumbnail_url yang sedia ada tidak berubah. Nilai lalai adalah false.

`Jun 1`

API Creative Lab baharu: satu keluarga endpoint khusus produk yang menukar foto sumber (atau prompt teks) kepada produk konsumer yang boleh dicetak dalam 3D. Empat produk pada pelancaran — rantai kunci, magnet peti sejuk, figura, dan lampu. Setiap satu mengikuti aliran kerja dua peringkat prototype → build yang dirantai melalui input_task_id, disediakan di bawah URL khusus produk (/openapi/creative-lab/<product>/v1/...) dengan versi mengikut setiap produk supaya produk boleh berkembang secara bebas mengikut barisan versi masing-masing. Prototype: 6 kredit setiap panggilan. Build: 30 kredit setiap panggilan.

Mei 2026

`May 26`

Parameter multi_view_thumbnails telah ditambah pada API Berbilang Imej ke 3D. Apabila ditetapkan kepada true, tugas tersebut turut merender empat lakaran kecil pandangan kardinal (depan, kanan, belakang, kiri) dan mengembalikannya di bawah medan respons thumbnail_urls yang baharu. Medan thumbnail_url yang sedia ada tidak berubah. Ini menambah lebih kurang 3 saat kepada kependaman tugas.

`May 22`

Fungsi tukar dan ubah saiz daripada Remesh API kini tersedia sebagai endpoint Convert API dan Resize API yang berasingan. Parameter lapuk pada Remesh akan terus berfungsi untuk keserasian ke belakang.

`13 Mei`

Menambah parameter multi_view_thumbnails pada API Imej ke 3D. Apabila ditetapkan kepada true, tugasan akan merender tambahan empat thumbnail pandangan utama (hadapan, kanan, belakang, kiri) dan mengembalikannya di bawah medan respons baharu thumbnail_urls. Medan thumbnail_url yang sedia ada tidak berubah. Ini menambah kira-kira 3 saat kepada kependaman tugasan.

`12 Mei`

Menambah parameter resize_longest_side pada API Remesh. Mengubah saiz model supaya dimensi kotak sempadan terpanjang bersamaan dengan nilai yang dinyatakan dalam meter. Tidak boleh digunakan bersama resize_height dan auto_size.

`11 Mei`

Parameter symmetry_mode pada endpoint Teks ke 3D, Imej ke 3D, dan Berbilang Imej ke 3D telah dilapukkan. Parameter ini tidak lagi menjejaskan output.

`7 Mei`

API Analisis kebolehcetakan baharu: Analisis tugas Meshy yang berjaya — atau mana-mana URL model 3D — untuk kesediaan pencetakan 3D FDM. Corak cipta-tak segerak + strim: POST mengembalikan task_id, kemudian GET / strim SSE mengembalikan metrik kekedapan air (watertightness), isipadu, lubang dan tepi non-manifold sebaik sahaja SUCCEEDED. Percuma, tiada kredit digunakan.
API Baiki kebolehcetakan baharu: Baiki model 3D untuk kebolehcetakan FDM — betulkan tepi non-manifold, muka degenerat, lubang, dan isu topology lain. Menerima input_task_id Meshy sedia ada atau model_url (.glb, .stl, .obj). Format output sepadan dengan input. 10 kredit setiap tugas.

April 2026

`Apr 27`

Menambah medan consumed_credits pada semua respons tugasan merentasi setiap endpoint API. Menunjukkan bilangan kredit yang digunakan oleh setiap tugasan. Medan ini hadir untuk tugasan dalam status PENDING, IN_PROGRESS, dan SUCCEEDED. Mengembalikan 0 untuk tugasan FAILED (kredit dikembalikan secara automatik apabila berlaku kegagalan). Lihat Harga untuk kos kredit bagi setiap endpoint.

`Apr 24`

Menambah parameter model_url pada endpoint Multi-Color Print. Hantar model 3D bertekstur secara terus (melalui URL atau Data URI) selain daripada input_task_id daripada tugasan Meshy sebelumnya. Format yang disokong: .glb, .fbx. Apabila kedua-dua model_url dan input_task_id diberikan, input_task_id mengambil keutamaan.

`Apr 21`

Menambah parameter input_task_id kepada endpoint Imej ke 3D dan Berbilang Imej ke 3D. Rujuk output tugas Teks ke Imej atau Imej ke Imej yang telah selesai secara terus berbanding menyediakan image_url / image_urls. Apabila kedua-duanya diberikan, input_task_id diutamakan.

`Apr 20`

Menambah parameter hd_texture kepada endpoint Imej ke 3D, Berbilang Imej ke 3D, Teks ke 3D Refine, dan Retekstur. Apabila diaktifkan, tekstur warna asas dijana pada resolusi 4K (4096×4096) untuk perincian yang lebih tinggi. Hanya disokong untuk meshy-6 dan latest. Lalai kepada false.
Bungkusan PBR yang dikembalikan apabila enable_pbr adalah true kini merangkumi peta emission di bawah texture_urls untuk tugas meshy-6 dan latest merentasi Imej ke 3D, Berbilang Imej ke 3D, Teks ke 3D Refine, dan Retekstur. Tiada perubahan permintaan diperlukan.

`Apr 14`

Menambah parameter decimation_mode pada endpoint Imej ke 3D, Berbilang Imej ke 3D, Teks ke 3D Preview, dan Remesh. Menetapkan tahap bilangan poligon decimation adaptif: 1 (ultra), 2 (tinggi), 3 (sederhana), atau 4 (rendah).

`Apr 12`

Menyusun semula dokumentasi API: menambah pengelompokan parameter dengan medan bergantung, nilai lalai sebaris, lencana wajib/lapuk, sub-navigasi boleh kembang, serta memisahkan Multi-Image, Rigging, dan Animasi ke halaman berasingan.

Mac 2026

`Apr 2`

Menambah sokongan format 3mf kepada parameter target_formats di seluruh endpoint (Imej ke 3D, Teks ke 3D, Remesh, Retekstur). Nota: 3MF adalah opt-in sahaja dan mesti diminta secara eksplisit.
API Cetakan Pelbagai Warna baharu Multi-Color Print API: Tukar model 3D kepada format 3MF pelbagai warna untuk pencetakan 3D. Menyokong palet 1-16 warna dengan ketepatan yang boleh dikonfigurasi. 10 kredit setiap tugas.

`Mar 20`

Menghentikan model AI Meshy-4. Semua permintaan API yang menggunakan meshy-4 tidak lagi disokong. Sila beralih kepada meshy-6 atau latest.
Menambah parameter auto_size dan origin_at pada endpoint Imej ke 3D, Berbilang Imej ke 3D, Teks ke 3D, dan Remesh. Apabila auto_size diaktifkan, perkhidmatan menggunakan penglihatan AI untuk menganggarkan ketinggian dunia sebenar dan mengubah saiz model secara automatik. origin_at menetapkan kedudukan titik asal (bottom atau center). Dalam API Remesh, auto_size saling eksklusif dengan resize_height.

`Mar 17`

Ditambahkan parameter target_formats pilihan kepada endpoint Imej ke 3D, Berbilang Imej ke 3D, Teks ke 3D, dan Retekstur. Nyatakan format 3D yang hendak dijana (contohnya, ["glb", "fbx"]) untuk mengurangkan masa penyiapan tugas.

Februari 2026

`Feb 28`

Ditambahkan parameter remove_lighting kepada API Imej ke 3D, Berbilang Imej ke 3D, Teks ke 3D Refine, dan Retekstur. Mengalih keluar sorotan dan bayang-bayang daripada tekstur warna asas untuk hasil yang lebih bersih di bawah pencahayaan tersuai. Hanya disokong untuk meshy-6 dan latest. Lalai kepada true.
API Retekstur dan Teks ke 3D Refine kini menyokong meshy-6 sebagai nilai ai_model untuk tekstur Meshy 6 penuh.

`Feb 25`

Menambahkan parameter image_enhancement pada API Imej ke 3D dan Berbilang Imej ke 3D untuk pengguna yang ingin memilih keluar daripada pengoptimuman imej input dan mengekalkan rupa sebenar input mereka. Hanya disokong untuk meshy-6 dan latest. Lalai kepada true.

`Feb 20`

Menambahkan parameter model_type pada API Teks ke 3D Preview untuk menjana mesh low-poly yang dioptimumkan untuk poligon yang lebih kemas.

Januari 2026

`Jan 27`

Menambah dokumentasi Mod Kegagalan yang terperinci untuk semua Endpoint API, termasuk kod ralat HTTP yang biasa (400, 401, 402, 404, 422, 429) dan sebab kegagalan tugas. Ini membantu pembangun memahami dan menangani ralat API dengan lebih baik.

`Jan 26`

API Berbilang Imej ke 3D kini menyokong Meshy-6 untuk penjanaan jejaring penuh. Parameter ai_model kini menerima meshy-6 dan latest akan diselesaikan kepada Meshy 6.

`22 Jan`

Melapuk art_style untuk API Pratonton Teks ke 3D (Meshy-6). Parameter ini direka untuk model lapuk (Meshy-4 / Meshy-5) dan akan dialih keluar dalam keluaran akan datang.
Melapuk enable_pbr untuk API Teks ke 3D dan Imej ke 3D apabila ai_model ialah meshy-4. Parameter ini akan dialih keluar dalam keluaran akan datang.
Mengemas kini nilai lalai bagi parameter should_remesh untuk Meshy-6 dalam API Teks ke 3D dan Imej ke 3D. Parameter ini kini lalai kepada false untuk meshy-6, dan true untuk model lain jika tidak dinyatakan.

`19 Jan`

Pilihan latest untuk ai_model dalam API Teks ke 3D (Preview) dan Imej ke 3D kini menggunakan Meshy 6.

`12 Jan`

Menambah parameter model_type baharu pada API Imej ke 3D untuk menjana mesh low-poly yang dioptimumkan untuk poligon yang lebih kemas.

Disember 2025

`31 Dis`

Melancarkan API Playground, ruang khusus untuk pembangun meneroka parameter API dan menguji permintaan terus di laman web Meshy.
Memperkenalkan API Teks ke Imej dan API Imej ke Imej, yang membolehkan penjanaan imej berkuasa AI daripada gesaan teks dan penyuntingan imej daripada imej rujukan. Kedua-dua API ini menyokong model nano-banana dan nano-banana-pro, dengan penjanaan Berbilang Pandangan pilihan.

`Dec 22`

Medan video_url dalam respons API Teks ke 3D kini lapuk dan akan dialih keluar dalam keluaran akan datang.

`Dec 04`

Menambah parameter pose_mode baharu kepada API Text to 3D Preview, Imej ke 3D, dan Berbilang Imej ke 3D. Parameter ini menerima a-pose, t-pose, atau rentetan kosong (lalai). Parameter is_a_t_pose kini lapuk dan digantikan dengan pose_mode.

November 2025

`Nov 24`

API Imej ke 3D dan Berbilang Imej ke 3D kini menambah parameter pilihan save_pre_remeshed_model dan mendedahkan model_urls.pre_remeshed_glb apabila sandaran pra-remesh diminta.

`Nov 06`

API Text to 3D Refine kini menyokong ai_model = latest, yang diselesaikan kepada Meshy 6 Preview.
API Imej ke 3D kini menggunakan tekstur Meshy-6-preview secara lalai apabila ai_model = latest dan should_texture = true.
API Berbilang Imej ke 3D kini menyokong ai_model = latest, menjalankan Meshy-6-preview untuk tekstur secara lalai manakala penjanaan jejaring kekal Meshy-5.
API Retekstur menambah pilihan latest untuk ai_model (Meshy-6-preview) dan kini menetapkannya secara lalai apabila ditinggalkan.

`04 Nov`

Remesh API kini mengekalkan texture untuk model yang dimuat naik.
Retexture API kini mengekalkan texture untuk model yang dimuat naik apabila pilihan enable_original_uv diaktifkan.

Oktober 2025

`28 Okt`

Menambah header respons x-api-version untuk menunjukkan versi pelayan API semasa.

`20 Okt`

Menambah parameter boolean pilihan convert_format_only kepada Remesh API untuk menyokong penukaran format fail model input sahaja.
Menambah rigged_character_glb_url kepada respons The Rigging Task Object.

`Oct 01`

Buang API text-to-voxel

September 2025

`Sep 23`

Menambah pilihan latest untuk ai_model dalam API Teks ke 3D untuk menggunakan Meshy 6 Preview.
Diskaun sementara 50% disediakan untuk tugas penjanaan Meshy-6-preview kepada 10 kredit yang akan berkekalan sehingga 30 Sep 2025. Selepas tempoh diskaun, kos tugas Meshy-6-preview akan kembali kepada 20 kredit seperti biasa.

`Sep 18`

Mengemas kini Harga API untuk Teks ke 3D dan Imej ke 3D bagi mencerminkan kos yang berbeza untuk Meshy 6 dan model lain.

`Sep 16`

Menambah pilihan latest untuk ai_model dalam API Image to 3D untuk menggunakan Meshy 6 Preview.

`Sep 4`

Mengembangkan sokongan input model_url kepada .glb, .gltf, .obj, .fbx, .stl untuk Remesh dan Retexture.

Ogos 2025

`Aug 18`

Menambah parameter pilihan is_a_t_pose kepada API Text to 3D Preview, Image to 3D, dan Multi-Image to 3D untuk menjana model dalam postur A/T.

`Aug 13`

Meshy 5 kini stabil untuk Teks ke 3D dan Imej ke 3D (ai_model: meshy-5), menghasilkan kualiti dan konsistensi yang lebih baik.

Julai 2025

`Jul 31`

Menyokong peta tekstur PBR dalam API melalui parameter enable_pbr untuk model meshy-5 terkini bagi endpoint Teks ke 3D, Imej ke 3D, Berbilang Imej ke 3D, dan Retekstur.

Jun 2025

`Jun 25`

Menambahkan API Retekstur, yang membolehkan pengguna mengretekstur model 3D berdasarkan model AI asas terkini Meshy.

`Jun 19`

Menambahkan API pemadaman untuk Teks ke 3D, Imej ke 3D, Remesh, Rigging, dan Animasi.
Menambahkan parameter ai_model kepada API Refine Teks ke 3D.

`Jun 17`

Menambahkan dokumentasi untuk Webhooks.

`Jun 10`

API Remesh kini menyokong model GLB yang dikodkan base64 dalam parameter model_url melalui Data URI.

Mei 2025

`May 20`

Menambah parameter pilihan moderation kepada API Text to 3D Preview, Text to 3D Refine, Image to 3D, dan Multi-Image to 3D. Apabila diaktifkan, kandungan input akan disaring secara automatik untuk kandungan yang berpotensi berbahaya sebelum penjanaan.

`15 Mei`

Memperkenalkan API Auto-rigging & Animasi, membolehkan pengguna untuk melakukan rigging dan animasi model 3D secara automatik. Ketahui lebih lanjut tentang Rigging dan Animasi.

April 2025

`29 Apr`

Memperkenalkan API Berbilang Imej ke 3D, yang membolehkan penjanaan model 3D daripada 1 hingga 4 imej input menggunakan model AI meshy-5.
Menambahkan pilihan model AI meshy-5 kepada API Teks ke 3D dan Imej ke 3D. Tag latest kini juga merujuk kepada meshy-5.

`Apr 17`

Menambahkan parameter texture_image_url ke API Imej ke 3D dan Teks ke 3D Refine, membolehkan pengguna memandu proses penjanaan tekstur dengan menggunakan imej.

Mac 2025

`Mar 28`

Menambahkan parameter latest ke API Teks ke 3D dan Imej ke 3D, membolehkan akses kepada model AI lanjutan kami yang akan datang untuk kualiti penjanaan yang lebih baik.

`Mar 14`

API Teks ke Tekstur kini menyokong model yang dikodkan dalam base64 pada parameter model_url melalui Data URI, sama seperti image_url dalam API Imej ke 3D.

`Mar 06`

Harga dikemas kini untuk tugas penjanaan API:
- Teks ke 3D (Preview): Meningkat daripada 2 kepada 5 kredit setiap panggilan
- Teks ke 3D (Refine): Meningkat daripada 5 kepada 10 kredit setiap panggilan
- Imej ke 3D: Kini 5 kredit tanpa tekstur, 15 kredit dengan tekstur
- Teks ke Tekstur: Meningkat daripada 5 kepada 10 kredit setiap panggilan
- Teks ke Voxel: Kekal pada 5 kredit setiap panggilan

Februari 2025

`Feb 18`

Menambah kunci API mod ujian yang membolehkan pembangun menguji integrasi API tanpa menggunakan kredit. Semua permintaan sah yang menggunakan kunci ini akan mengembalikan hasil tugas sampel yang sama.

`Feb 13`

Perubahan Besar:
- Penciptaan tugas peringkat percuma akan berakhir pada March 20, 2025. Selepas itu, semua permintaan tugas API akan memerlukan langganan berbayar. Untuk memastikan akses anda berjalan lancar, kami mengesyorkan anda menaik taraf sebelum tarikh akhir tersebut.
- Gunakan kod kupon APIACCESS untuk menikmati diskaun 40%. Terima kasih kerana terus bersama kami!
Menambah endpoint penstriman Server-Sent Events (SSE) untuk kemas kini tugas masa nyata:

`Feb 6`

Menambah parameter texture_prompt pada API Imej ke 3D dan Teks ke 3D Refine, membolehkan pengguna membimbing proses penjanaan tekstur dengan prompt teks.

January 2025

`Jan 23`

Menambah endpoint untuk menyenaraikan tugas pada API Teks ke 3D, Imej ke 3D, Remesh dan Teks ke Tekstur.

`Jan 14`

Melapukkan API Teks ke 3D dan Imej ke 3D legacy yang dikuasakan oleh model AI Meshy-3.

`Jan 07`

Menambah parameter symmetry_mode pada API Pratonton Teks ke 3D dan Imej ke 3D, membolehkan tetapan simetri yang boleh dikonfigurasikan.

Disember 2024

`Dec 19`

Menambah API Remesh, yang membolehkan pengguna melakukan remesh dan mengeksport model 3D sedia ada yang dijana oleh API Meshy lain ke pelbagai format.
Mengemas kini had bilangan poligon untuk API kami kepada julat 100-300,000 bagi pengguna Premium.

`Dec 12`

Melapukkan sifat model_url dalam semua objek respons.
Memisahkan API Meshy-3 lapuk daripada API Meshy-4 terkini.

`Dec 10`

Menambah parameter enable_pbr pada API Imej ke 3D dan Text to 3D Refine.
Menambah parameter should_texture pada API Imej ke 3D.
Melapukkan pilihan pbr dalam parameter art_style untuk API Text to 3D Preview apabila menggunakan model AI meshy-4.
Melapukkan pilihan low-poly dalam parameter art_style untuk API Text to 3D Preview.

`Dec 5`

Menambahkan Get Balance API untuk membolehkan pengguna mendapatkan semula baki kredit mereka.
Menambahkan parameter should_remesh kepada API Imej ke 3D dan Text to 3D Preview.

`Dec 3`

API luaran kini menggunakan awalan /openapi. Laluan Legacy masih disokong, tetapi kami mengesyorkan beralih kepada laluan baharu.

November 2024

`Nov 14`

API Imej ke 3D kini menyokong imej yang dikodkan base64.