lowpoly akan dihentikan pada 30 Okt 2026. Tukar model sebelum tarikh-tarikh ini untuk mengelakkan ralat permintaan. Lihat semua penamatan

Integrasi AI

Sambungkan ejen AI dan pembantu pengekodan kepada Meshy, dengan Meshy MCP server untuk panggilan alat, atau dengan llms.txt dan llms-full.txt untuk membaca dokumentasi.

Jika anda menggunakan Claude Code, Cursor, Windsurf, Codex, atau klien MCP lain, pasang MCP server. Jika ejen sembang anda tidak menyokong MCP, arahkan ia ke https://docs.meshy.ai/llms.txt sebagai gantinya.

Apakah itu MCP

Model Context Protocol (MCP) ialah piawaian terbuka yang membolehkan pembantu AI memanggil alat luaran dan mendapatkan konteks berstruktur. Meshy MCP server membungkus Meshy API REST sebagai alat yang boleh dipanggil oleh ejen anda. Dengannya, ejen boleh menjana model, menyemak tugas, dan memuat turun hasilnya tanpa kod HTTP yang ditulis tangan.

MCP server adalah sumber terbuka. Ia diterbitkan di npm sebagai @meshy-ai/meshy-mcp-server, dan sumbernya terdapat dalam repositori meshy-mcp-server di GitHub.

Anda memerlukan kunci API Meshy. Cipta satu di halaman Kunci API pada Developer Platform. MCP server membacanya daripada pembolehubah persekitaran MESHY_API_KEY.

Pasang MCP server

Untuk memasang server, gunakan tab untuk klien AI anda. Gantikan msy_YOUR_API_KEY dengan kunci API anda.

# Detects installed AI clients and configures Meshy for each
npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY

Lebih suka skill? Pakej skill sumber terbuka meshy-3d-agent mempunyai aliran kerja Meshy sedia pakai untuk Claude Code, Cursor, dan OpenClaw, seperti menjana model, melakukan polling pada tugas, dan memuat turun hasilnya. Ia memanggil Meshy API REST secara langsung, jadi anda tidak memerlukan MCP server.

npx skills add meshy-dev/meshy-3d-agent

Alat yang tersedia

MCP server menawarkan Meshy API REST sebagai alat berikut, dikumpulkan mengikut keupayaan.

Penjanaan 3D

  • meshy_text_to_3d: cipta jejaring pratonton tanpa tekstur daripada prompt teks
  • meshy_image_to_3d: cipta model 3D daripada satu imej
  • meshy_multi_image_to_3d: cipta model 3D daripada berbilang imej objek yang sama
  • meshy_text_to_3d_refine: tambah tekstur pada jejaring pratonton

Pascapemprosesan

  • meshy_remesh: ubah topology atau bilangan poligon model sedia ada, atau kedua-duanya
  • meshy_retexture: guna pakai tekstur baharu pada model sedia ada
  • meshy_rig: tambah rangka pada watak humanoid 3D
  • meshy_animate: guna pakai animasi pada watak yang telah di-rig
  • meshy_convert: tukar model kepada format fail lain
  • meshy_resize: ubah saiz model kepada dimensi dunia sebenar
  • meshy_uv_unwrap: jana susun atur UV baharu untuk model
  • meshy_text_to_motion: jana animasi daripada prompt teks
  • meshy_list_animations: cari ID tindakan animasi praset, secara percuma

Creative Lab

  • meshy_creative_lab: tukar foto menjadi produk Creative Lab yang lengkap (menjalankan tugas prototaip dan pembinaan)

Penjanaan imej

  • meshy_text_to_image: cipta imej 2D daripada teks
  • meshy_image_to_image: cipta imej 2D daripada imej rujukan

Pengurusan tugas

  • meshy_get_task_status: semak status tugas dan URL muat turun
  • meshy_list_tasks: senaraikan tugas terkini, boleh ditapis mengikut jenis atau status
  • meshy_cancel_task: padam tugas. Meshy mengeluarkan dan membayar balik tugas PENDING, dan memadam tugas yang telah selesai. Tugas IN_PROGRESS tidak boleh dibatalkan, dan API mengembalikan 409.
  • meshy_download_model: muat turun fail model yang telah selesai dan simpan secara tempatan

Ruang kerja

  • meshy_list_models: senaraikan model Teks ke 3D terkini anda. Untuk jenis tugas lain, gunakan meshy_list_tasks.

Pencetakan 3D

  • meshy_send_to_slicer: cari slicer yang dipasang pada komputer anda, dan kembalikan arahan yang membuka model dalam salah satu daripadanya. Ia berjalan secara tempatan dan tidak memanggil Meshy API.
  • meshy_analyze_printability: semak kebolehcetakan FDM model secara percuma, termasuk kekedapan air, isipadu, lubang, tepi non-manifold, dan muka degenerat
  • meshy_process_multicolor: tukar model bertekstur kepada fail 3MF berbilang warna untuk pencetakan
  • meshy_repair_printability: baiki model untuk pencetakan FDM
  • meshy_auto_split: pecahkan model kepada bahagian yang boleh dicetak secara berasingan

Akaun

  • meshy_check_balance: semak baki kredit anda
  • meshy_list_usage: senaraikan tugas API yang telah selesai bagi pasukan anda dan kredit yang digunakan oleh setiap satu, untuk pasukan Studio dan Enterprise

Nama dan tingkah laku alat boleh berubah. Untuk senarai penuh, lihat alat dalam sumber MCP server.

Contoh prompt

Untuk bermula, cuba prompt berikut dalam sembang berupaya MCP anda:

Generate a 3D fox from the prompt "a cartoon fox sitting", preview it, then
texture it with PBR maps. Download the final GLB to ./outputs.

Take the image at https://example.com/sculpture.jpg and convert it into a
riggable 3D character. Use `should_remesh: true` and 50k target polycount.

What's my current Meshy credit balance?

List my last 10 successful text-to-3d tasks and download the top 3 as GLB
into ./downloads/.

llms.txt dan llms-full.txt

Jika ejen anda tidak menyokong MCP, atau anda ingin memasukkan dokumentasi Meshy terus ke dalam prompt, arahkan ia ke versi teks biasa dokumentasi tersebut:

  • llms.txt: indeks ringkas dengan arahan integrasi, seperti cara melakukan polling pada tugas async, pengesahan, had kadar, pemilihan model, dan kesilapan biasa.
  • llms-full.txt: setiap halaman API dalam satu fail, supaya ejen boleh membaca dokumentasi dalam satu permintaan.
  • Markdown setiap halaman: tambah .md pada mana-mana URL endpoint, contohnya https://docs.meshy.ai/api/text-to-3d.md.

Meshy menjana semula ketiga-tiganya setiap kali laman dokumentasi dibina, supaya ia sepadan dengan dokumentasi HTML.

Soalan Lazim

Adakah MCP server bersifat stateless?
Ia tidak menyimpan kelayakan anda. Server menyimpan MESHY_API_KEY anda dalam memori dan tidak pernah menulisnya ke cakera. Secara lalai, ia menyimpan model yang dimuat turunnya, berserta metadatanya, dalam folder meshy_output di direktori kerjanya. Untuk menyimpan muat turun di tempat lain, berikan alat muat turun laluan save_to.
Adakah MCP dikenakan kos yang sama seperti API REST?
Ya. Panggilan alat MCP membuat panggilan REST yang sama dan menggunakan kredit pada kadar yang sama. Lihat halaman Harga untuk setiap harga.
Apakah had kadarnya?
Panggilan MCP server dikira ke arah had kadar yang sama seperti panggilan API REST anda. Lihat halaman Had Kadar untuk had setiap pelan.
Data Meshy apakah yang boleh diakses oleh MCP server?
Hanya apa yang boleh diakses oleh MESHY_API_KEY anda melalui API REST, dengan kebenaran yang sama.
Bagaimana saya melaporkan isu?
Buka satu isu dalam repositori meshy-mcp-server di GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues