Mula pantas
Mulakan dengan mencipta kunci API anda
Setiap permintaan dalam panduan ini memerlukan satu. Mencipta kunci mengambil masa kurang dari satu minit.
Cipta kunci API andaEmpat langkah untuk model 3D pertama anda, menggunakan Meshy REST API.
Menggunakan pembantu pengekodan AI? Lihat halaman Integrasi AI kami — pasang server Meshy MCP untuk akses panggilan alat dari Claude Code, Cursor, Windsurf, dan alat lain yang serasi dengan MCP, atau arahkan agen sembang biasa ke llms.txt.
1Dapatkan kunci API anda
Cipta kunci API dari tetapan akaun anda — anda tidak akan dapat melihatnya lagi selepas skrin ini, jadi simpan di tempat yang selamat. Setiap permintaan mengesahkan dengan token Bearer dalam header Authorization — lihat Pengesahan.

Petua keselamatan: elakkan menampal kunci anda terus ke dalam skrip — simpan sebagai pembolehubah persekitaran: export MESHY_API_KEY="msy_...".
2Buat permintaan Imej-ke-3D pertama anda
Eksport kunci anda, kemudian cipta tugasan pertama anda dengan Imej ke 3D. Bekerja dari prompt teks atau pelbagai foto sebaliknya? Lihat Teks ke 3D atau Berbilang Imej ke 3D.
Eksport kunci anda
export MESHY_API_KEY="<your-api-key>"
Jalankan ini dalam terminal anda (Terminal pada macOS, Command Prompt atau PowerShell pada Windows) — bukan dalam pelayar.
Setiap contoh di bawah menggunakan foto ini — tukar image_url anda sendiri untuk mencuba sesuatu yang lain.

Permintaan
curl https://api.meshy.ai/openapi/v1/image-to-3d \
-X POST \
-H "Authorization: Bearer ${MESHY_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://docs.meshy.cn/images/api/quick-start/source-photo.webp"
}'
3Semak status tugasan
Permintaan mengembalikan ID tugasan dengan segera. Poll endpoint yang sama sehingga status adalah SUCCEEDED — gantikan <task_id> di bawah dengan ID yang dikembalikan dalam langkah 2.
Permintaan
curl https://api.meshy.ai/openapi/v1/image-to-3d/<task_id> \
-H "Authorization: Bearer ${MESHY_API_KEY}"
Respons — SUCCEEDED
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"status": "SUCCEEDED",
"progress": 100,
"model_urls": {
"glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
"fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***"
},
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"task_error": {
"message": ""
}
}
Polling bukan gaya anda? Gunakan penstriman SSE atau webhook untuk diberitahu sebaik sahaja tugasan selesai.
4Muat turun model anda
Ambil model dari model_urls dalam respons di atas. Setiap format (GLB, FBX, OBJ, USDZ, STL) adalah URL yang ditandatangani dan terhad masa — atau langkau baris perintah dan tampal URL terus ke bar alamat pelayar anda untuk memuat turunnya.
Muat turun
curl -L "<model_urls.glb from the response above>" -o model.glb

Fail disimpan selama 3 hari pada pelan bukan-Enterprise — lihat Pengekalan Aset.
Gabungkan semuanya
Lebih suka satu skrip yang melakukan semuanya — cipta, poll, muat turun?
Skrip penuh
import axios from 'axios';
import fs from 'fs';
const headers = { Authorization: `Bearer ${process.env.MESHY_API_KEY}` };
const imageUrl = 'https://docs.meshy.cn/images/api/quick-start/source-photo.webp';
// 1. Create the task
const { data: created } = await axios.post(
'https://api.meshy.ai/openapi/v1/image-to-3d',
{ image_url: imageUrl },
{ headers },
);
const taskId = created.result;
// 2. Poll until it finishes
let task;
while (true) {
const { data } = await axios.get(`https://api.meshy.ai/openapi/v1/image-to-3d/${taskId}`, { headers });
task = data;
if (task.status === 'SUCCEEDED' || task.status === 'FAILED') break;
await new Promise((resolve) => setTimeout(resolve, 5000));
}
// 3. Download the result (only if the task succeeded)
if (task.status !== 'SUCCEEDED') {
throw new Error(`Task ${task.status}: ${task.task_error?.message || 'unknown error'}`);
}
const { data: model } = await axios.get(task.model_urls.glb, { responseType: 'arraybuffer' });
fs.writeFileSync('model.glb', model);
console.log('Saved model.glb');
Terokai aliran kerja biasa
Watak sedia untuk permainan
Rangkaikan jejaring humanoid dengan rangka supaya ia sedia untuk dianimasikan dalam Unity atau Unreal.
Learn more →Aset lowpoly
Tetapkan model_type kepada lowpoly pada Imej ke 3D untuk jejaring yang bersih dan sedia untuk permainan.
Model cetakan 3D
Tukar model siap ke dalam fail 3MF berbilang warna, sedia untuk dipotong dan dicetak.
Learn more →Langkah seterusnya
- Lebih suka UI? Cuba API Playground — konfigurasikan permintaan, jalankannya, dan salin kod yang dihasilkan.
- Semak rujukan API penuh untuk setiap endpoint.
- Semak Harga, Had Kadar, dan Ralat sebelum anda pergi ke produksi.
- Tonton log perubahan untuk kemas kini dan pembetulan pepijat.
- Ada maklum balas atau menghadapi masalah? Sertai komuniti Discord kami — kami ingin mendengar daripada anda!