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

Integrasi AI

Meshy mendedahkan dua saluran untuk ejen AI dan pembantu pengekodan: MCP server Meshy untuk pemanggilan alat, dan llms.txt / llms-full.txt untuk pengambilan dokumentasi.

Jika anda mengintegrasikan Meshy dari Claude Code, Cursor, Windsurf, Codex, atau mana-mana alat lain yang serasi dengan MCP, pasang MCP server di bawah. Jika anda mengintegrasikan daripada ejen sembang biasa tanpa sokongan MCP, arahkannya ke https://docs.meshy.ai/llms.txt sebagai gantinya.


Apakah itu MCP

Model Context Protocol (MCP) ialah standard terbuka yang membolehkan pembantu AI memanggil alat luaran dan mendapatkan konteks berstruktur. MCP server Meshy membalut Meshy API REST sebagai satu set alat yang boleh dipanggil oleh ejen anda — menjana model, menyemak tugas, memuat turun hasil — tanpa perlu menulis kod HTTP secara manual.

MCP server adalah sumber terbuka dan diterbitkan di npm sebagai @meshy-ai/meshy-mcp-server. Sumber: github.com/meshy-dev/meshy-mcp-server.


Pemasangan Pantas

# 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

Alatan Tersedia

MCP server mendedahkan Meshy API REST sebagai alat, 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 pelbagai imej objek yang sama
  • meshy_text_to_3d_refine: tambah tekstur pada jejaring pratonton

Pascapemprosesan

  • meshy_remesh: ubah topology dan/atau bilangan poligon model sedia ada
  • 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 ke format fail lain
  • meshy_resize: ubah saiz model kepada dimensi dunia sebenar
  • meshy_uv_unwrap: jana susun atur UV baharu untuk model

Creative Lab

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

Penjanaan Imej

  • meshy_text_to_image: imej 2D daripada teks
  • meshy_image_to_image: 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/status
  • meshy_cancel_task: padam tugas. Tugas PENDING dialih keluar dan dibayar balik; tugas IN_PROGRESS tidak boleh dibatalkan (API memulangkan 409); tugas yang telah selesai akan dipadam.
  • meshy_download_model: dapatkan fail model yang telah siap dan simpan secara tempatan

Ruang Kerja

  • meshy_list_models: senaraikan model Teks ke 3D terkini anda (gunakan meshy_list_tasks untuk jenis tugas lain)

Pencetakan 3D

  • meshy_send_to_slicer: kesan slicer yang dipasang dan pulangkan arahan untuk membuka model di dalamnya (berjalan secara tempatan; tiada panggilan Meshy API)
  • meshy_analyze_printability: pemeriksaan kebolehcetakan FDM automatik percuma (kekedapan air, isipadu, lubang, tepi non-manifold, muka degenerat)
  • meshy_process_multicolor: tukar model bertekstur menjadi fail 3MF berbilang warna untuk pencetakan
  • meshy_repair_printability: baiki model untuk pencetakan FDM

Akaun

  • meshy_check_balance: pertanyaan baki kredit yang tinggal

Contoh Prompt

Masukkan ini ke dalam sembang anda yang disokong MCP sebagai titik permulaan.

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 menyerap dokumentasi Meshy terus ke dalam prompt, arahkannya ke permukaan teks biasa kami:

  • llms.txt — indeks ringkas + arahan integrasi (corak tinjauan async yang betul, peraturan pengesahan, had kadar, pemilihan model, kesilapan biasa).
  • llms-full.txt — setiap halaman API digabungkan dalam satu fail untuk penyerapan satu-tarikan.
  • Markdown setiap halaman: tambah .md pada mana-mana URL endpoint. Contoh: https://docs.meshy.ai/api/text-to-3d.md.

Ketiga-tiganya dijana semula setiap kali laman dokumentasi dibina, jadi ia tidak pernah terpesong daripada dokumentasi HTML.


Soalan Lazim

Adakah MCP server stateless?
Ya. MESHY_API_KEY anda digunakan bagi setiap permintaan dan tidak pernah disimpan di sisi server.
Adakah MCP dikenakan kos yang sama seperti API REST?
Ya — setiap panggilan alat MCP dipetakan kepada satu panggilan REST dan menggunakan kredit pada kadar yang sama persis. Lihat laman Pricing untuk matriks penuh.
Apakah had kadar yang dikenakan?
MCP server berkongsi satah had kadar yang sama dengan API REST. Lihat laman Rate Limits untuk had mengikut setiap peringkat.
Data Meshy manakah yang boleh diakses oleh MCP?
Hanya apa yang boleh diakses oleh MESHY_API_KEY melalui REST. Skop dan kebenaran adalah sama.
Bagaimana saya boleh melaporkan isu?
Failkan isu di repositori meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues