Mula pantas

Empat langkah untuk mendapatkan model 3D pertama anda, menggunakan Meshy REST API.

1Dapatkan kunci API anda

Buat kunci API daripada halaman API Keys dalam Developer Platform — anda tidak akan dapat melihatnya semula selepas skrin ini, jadi simpan di tempat yang selamat. Setiap permintaan disahkan dengan token Bearer dalam header Authorization — lihat Pengesahan.

2Buat permintaan Imej-ke-3D pertama anda

Eksport kunci anda, kemudian buat tugas pertama anda dengan Imej ke 3D. Bekerja daripada prompt teks atau beberapa foto sebaliknya? Lihat Teks ke 3D atau Berbilang Imej ke 3D.

export MESHY_API_KEY="<your-api-key>"

Setiap contoh di bawah menggunakan foto ini — gantikan dengan image_url anda sendiri untuk mencuba sesuatu yang lain.

Copy image URL

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.ai/images/api/quick-start/source-photo.webp"
  }'

3Semak status tugas

Permintaan mengembalikan ID tugas dengan segera. Tinjau endpoint yang sama sehingga status adalah SUCCEEDED — gantikan <task_id> di bawah dengan ID yang dikembalikan dalam langkah 2.

curl https://api.meshy.ai/openapi/v1/image-to-3d/<task_id> \
  -H "Authorization: Bearer ${MESHY_API_KEY}"

{
  "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": ""
  }
}

4Muat turun model anda

Dapatkan model daripada model_urls dalam respons di atas. Setiap format (GLB, FBX, OBJ, USDZ, STL) adalah URL yang ditandatangani dan terhad masa — atau langkau baris arahan dan tampal URL terus ke bar alamat pelayar anda untuk memuat turunnya.

curl -L "<model_urls.glb from the response above>" -o model.glb

Gabungkan semuanya

Lebih suka satu skrip yang melakukan keseluruhan proses — cipta, tinjau, muat turun?

import axios from 'axios';
import fs from 'fs';

const headers = { Authorization: `Bearer ${process.env.MESHY_API_KEY}` };
const imageUrl = 'https://docs.meshy.ai/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, headers: resHeaders } = await axios.get(`https://api.meshy.ai/openapi/v1/image-to-3d/${taskId}`, { headers });
  task = data;
  if (task.status === 'SUCCEEDED' || task.status === 'FAILED') break;
  const waitSeconds = Number(resHeaders['retry-after']) || 5;
  await new Promise((resolve) => setTimeout(resolve, waitSeconds * 1000));
}

// 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

Langkah seterusnya

• Lebih suka UI? Buka Developer Platform — jalankan permintaan dalam Playground, jejaki penggunaan dan log permintaan, serta uruskan webhook.
• Layari rujukan API yang lengkap untuk setiap endpoint.
• Belajar daripada contoh yang berfungsi: ikuti resipi langkah demi langkah dalam Cookbook dan baca tutorial serta cerita pembinaan di Developer Blog.
• Semak Harga, Had Kadar, dan Ralat sebelum anda pergi ke pengeluaran.
• Pantau log perubahan untuk kemas kini dan pembaikan pepijat.
• Ada maklum balas atau menghadapi masalah? Sertai komuniti Discord kami — kami ingin mendengar daripada anda!