Bắt đầu nhanh
Bắt đầu bằng cách tạo khóa API của bạn
Mỗi yêu cầu trong hướng dẫn này cần một khóa. Tạo một khóa mất chưa đến một phút.
Tạo khóa API của bạnBốn bước để có mô hình 3D đầu tiên của bạn, sử dụng Meshy REST API.
Sử dụng trợ lý mã hóa AI? Xem trang Tích hợp AI của chúng tôi — cài đặt máy chủ Meshy MCP để truy cập công cụ từ Claude Code, Cursor, Windsurf và các công cụ tương thích MCP khác, hoặc chỉ định một tác nhân trò chuyện thông thường tại llms.txt.
1Nhận khóa API của bạn
Tạo khóa API từ cài đặt tài khoản của bạn — bạn sẽ không thể xem lại nó sau màn hình này, vì vậy hãy lưu trữ nó ở nơi an toàn. Mỗi yêu cầu xác thực với một mã Bearer trong tiêu đề Authorization — xem Xác thực.

Mẹo bảo mật: tránh dán khóa của bạn trực tiếp vào các tập lệnh — thay vào đó, lưu trữ nó dưới dạng biến môi trường: export MESHY_API_KEY="msy_...".
2Thực hiện yêu cầu Ảnh sang 3D đầu tiên của bạn
Xuất khóa của bạn, sau đó tạo tác vụ đầu tiên của bạn với Ảnh sang 3D. Làm việc từ một prompt văn bản hoặc nhiều ảnh thay thế? Xem Văn bản sang 3D hoặc Nhiều ảnh sang 3D.
Xuất khóa của bạn
export MESHY_API_KEY="<your-api-key>"
Chạy điều này trong terminal của bạn (Terminal trên macOS, Command Prompt hoặc PowerShell trên Windows) — không phải trong trình duyệt.
Mỗi ví dụ dưới đây sử dụng bức ảnh này — thay thế bằng image_url của riêng bạn để thử điều gì khác.

Yêu cầu
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"
}'
3Kiểm tra trạng thái tác vụ
Các yêu cầu trả về một ID tác vụ ngay lập tức. Thăm dò cùng endpoint cho đến khi status là SUCCEEDED — thay thế <task_id> dưới đây bằng ID được trả về trong bước 2.
Yêu cầu
curl https://api.meshy.ai/openapi/v1/image-to-3d/<task_id> \
-H "Authorization: Bearer ${MESHY_API_KEY}"
Phản hồi — 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": ""
}
}
Không thích thăm dò? Sử dụng SSE streaming hoặc một webhook để nhận thông báo ngay khi một tác vụ hoàn thành.
4Tải xuống mô hình của bạn
Lấy mô hình từ model_urls trong phản hồi trên. Mỗi định dạng (GLB, FBX, OBJ, USDZ, STL) là một URL có chữ ký, giới hạn thời gian — hoặc bỏ qua dòng lệnh và dán URL trực tiếp vào thanh địa chỉ của trình duyệt của bạn để tải xuống.
Tải xuống
curl -L "<model_urls.glb from the response above>" -o model.glb

Các tệp được lưu giữ trong 3 ngày trên các gói không phải Enterprise — xem Lưu giữ tài nguyên.
Tổng hợp tất cả
Thích một tập lệnh thực hiện toàn bộ — tạo, thăm dò, tải xuống?
Tập lệnh đầy đủ
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');
Khám phá các quy trình làm việc phổ biến
Nhân vật sẵn sàng cho game
Rig một lưới hình người với khung xương để sẵn sàng hoạt hình trong Unity hoặc Unreal.
Learn more →Tài nguyên lowpoly
Đặt model_type thành lowpoly trên Ảnh sang 3D để có một lưới sạch, sẵn sàng cho game.
Mô hình in 3D
Chuyển đổi một mô hình hoàn chỉnh thành tệp 3MF đa màu, sẵn sàng để cắt và in.
Learn more →Các bước tiếp theo
- Thích giao diện người dùng? Thử API Playground — cấu hình một yêu cầu, chạy nó và sao chép mã được tạo.
- Duyệt qua tài liệu tham khảo API đầy đủ cho mọi endpoint.
- Kiểm tra Giá, Giới hạn Tốc độ, và Lỗi trước khi bạn đi vào sản xuất.
- Theo dõi Nhật ký thay đổi để cập nhật và sửa lỗi.
- Có phản hồi hoặc gặp vấn đề? Tham gia cộng đồng Discord của chúng tôi — chúng tôi rất mong nhận được phản hồi từ bạn!