เริ่มต้นอย่างรวดเร็ว
เริ่มต้นด้วยการสร้าง API คีย์ของคุณ
ทุกคำขอในคู่มือนี้ต้องใช้ API คีย์ การสร้างคีย์ใช้เวลาเพียงไม่กี่วินาที
สร้าง API คีย์ของคุณสี่ขั้นตอนสู่โมเดล 3D แรกของคุณ โดยใช้ Meshy REST API
ใช้ผู้ช่วยเขียนโค้ด AI อยู่หรือเปล่า? ดูหน้า การเชื่อมต่อ AI ของเรา — ติดตั้ง Meshy MCP server เพื่อเข้าถึงการเรียกใช้เครื่องมือ (tool-calling) จาก Claude Code, Cursor, Windsurf และเครื่องมืออื่น ๆ ที่รองรับ MCP หรือชี้ chat agent ทั่วไปไปที่ llms.txt
1รับ API คีย์ของคุณ
สร้าง API คีย์ จากหน้า API Keys ใน Developer Platform — คุณจะไม่สามารถดูคีย์นี้อีกครั้งหลังจากหน้าจอนี้ ดังนั้นควรเก็บไว้ในที่ปลอดภัย ทุกคำขอจะยืนยันตัวตนด้วย Bearer token ใน header ที่ชื่อ Authorization — ดู Authentication
การสร้างและจัดการ API คีย์ต้องใช้แผน แบบชำระเงิน บัญชี ฟรี จะได้รับคีย์เฉพาะที่มีมาให้ในตัวสำหรับทดสอบใน Playground แต่ไม่สามารถสร้างหรือจัดการคีย์ของตัวเองได้

เคล็ดลับด้านความปลอดภัย: หลีกเลี่ยงการวางคีย์ของคุณลงในสคริปต์โดยตรง — ให้เก็บไว้เป็นตัวแปรสภาพแวดล้อม (environment variable) แทน: export MESHY_API_KEY="msy_..."
2สร้างคำขอ Image-to-3D แรกของคุณ
Export คีย์ของคุณ จากนั้นสร้างงานแรกของคุณด้วย Image to 3D หากต้องการทำงานจาก prompt ข้อความหรือรูปภาพหลายรูปแทน โปรดดู Text to 3D หรือ Multi-Image to 3D
Export your key
export MESHY_API_KEY="<your-api-key>"
รันคำสั่งนี้ในเทอร์มินัลของคุณ (Terminal บน macOS, Command Prompt หรือ PowerShell บน Windows) — ไม่ใช่ในเบราว์เซอร์
ตัวอย่างทุกตัวอย่างด้านล่างนี้ใช้รูปภาพนี้ — สลับไปใช้ image_url ของคุณเองเพื่อลองสิ่งอื่น

Request
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"
}'
3ตรวจสอบสถานะงาน
คำขอจะส่งคืนรหัสงานทันที ให้ polling ไปที่ endpoint เดียวกันจนกว่า status จะเป็น SUCCEEDED — แทนที่ <task_id> ด้านล่างด้วย ID ที่ได้รับในขั้นตอนที่ 2
Request
curl https://api.meshy.ai/openapi/v1/image-to-3d/<task_id> \
-H "Authorization: Bearer ${MESHY_API_KEY}"
Response — 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? ใช้ SSE streaming หรือ webhook เพื่อรับการแจ้งเตือนทันทีที่งานเสร็จสิ้น
4ดาวน์โหลดโมเดลของคุณ
รับโมเดลจาก model_urls ในคำตอบด้านบน แต่ละรูปแบบ (GLB, FBX, OBJ, USDZ, STL) เป็น URL ที่มีลายเซ็นและจำกัดเวลา — หรือข้ามบรรทัดคำสั่งและวาง URL ลงในแถบที่อยู่ของเบราว์เซอร์โดยตรงเพื่อดาวน์โหลด
Download
curl -L "<model_urls.glb from the response above>" -o model.glb

ไฟล์จะถูกเก็บรักษาไว้ 3 วันในแผนที่ไม่ใช่ Enterprise — ดู Asset Retention
รวมทุกอย่างเข้าด้วยกัน
ต้องการสคริปต์เดียวที่ทำทุกอย่าง — สร้าง, polling, ดาวน์โหลด?
Full script
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 } = 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');
สำรวจเวิร์กโฟลว์ที่พบบ่อย
ตัวละครพร้อมใช้ในเกม
ทำ rig ให้กับเมชรูปมนุษย์ด้วยโครงกระดูก เพื่อให้พร้อมสำหรับสร้างแอนิเมชันใน Unity หรือ Unreal
Learn more →แอสเซ็ต Lowpoly
ตั้งค่า model_type เป็น lowpoly ใน Image to 3D เพื่อให้ได้เมชที่สะอาดและพร้อมใช้ในเกม
โมเดลสำหรับพิมพ์ 3D
แปลงโมเดลที่เสร็จสมบูรณ์ให้เป็นไฟล์ 3MF แบบหลายสี พร้อมสำหรับการ slice และพิมพ์
Learn more →ขั้นตอนถัดไป
- ต้องการใช้ UI ใช่ไหม? เปิด Developer Platform — รันคำขอใน Playground ติดตามการใช้งานและบันทึกคำขอ และจัดการ webhooks
- เรียกดู API reference ฉบับเต็มสำหรับทุกเอนด์พอยต์
- ตรวจสอบ Pricing, Rate Limits และ Errors ก่อนนำไปใช้งานจริง
- ติดตาม Changelog เพื่อดูการอัปเดตและการแก้ไขบั๊ก
- มีความคิดเห็นหรือพบปัญหา? เข้าร่วมคอมมูนิตี้ Discord ของเรา — เรายินดีรับฟังจากคุณ!