Bắt đầu nhanh
Bắt đầu bằng việc 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 API. Việc tạo một khóa mất chưa đầy 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ỉ một agent chat thông thường tại llms.txt.
1Lấy khóa API của bạn
Tạo một 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ì thế hãy lưu trữ nó ở nơi an toàn. Mọi yêu cầu đều xác thực với một token Bearer trong header Authorization — xem Xác thực.

Mẹo bảo mật: tránh dán trực tiếp khóa của bạn vào các tập lệnh — thay vào đó, lưu trữ nó như một biến môi trường: export MESHY_API_KEY="msy_...".
2Tạo 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 với Ảnh sang 3D. Làm việc từ một prompt văn bản hoặc nhiều bức ảnh? 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 lệnh này trong terminal (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 đều sử dụng bức ảnh này — thay thế bằng image_url riêng của 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.ai/images/api/quick-start/source-photo.webp"
}'
3Kiểm tra trạng thái tác vụ
Yêu cầu sẽ trả về mã số tác vụ ngay lập tức. Kiểm tra liên tục cùng một endpoint cho đến khi status là SUCCEEDED — thay thế <task_id> dưới đây bằng mã ID 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 kiểm tra liên tục? Sử dụng SSE streaming hoặc một webhook để nhận thông báo ngay khi tác vụ hoàn thành.
4Tải về mô hình của bạn
Tải 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 ký, có thời hạn — 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 để tải về.
Tải về
curl -L "<model_urls.glb từ phản hồi trên>" -o model.glb

Các tập tin đượ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.
Kết hợp tất cả lại với nhau
Thích một tập lệnh làm mọi thứ — tạo, kiểm tra, tải về?
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.ai/images/api/quick-start/source-photo.webp';
// 1. Tạo tác vụ
const { data: created } = await axios.post(
'https://api.meshy.ai/openapi/v1/image-to-3d',
{ image_url: imageUrl },
{ headers },
);
const taskId = created.result;
// 2. Kiểm tra liên tục cho đến khi hoàn thành
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. Tải kết quả
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á quy trình làm việc thông dụng
Nhân vật sẵn sàng cho game
Rig một lưới hình người với một khung xương để sẵn sàng cho việc hoạt họa trong Unity hoặc Unreal.
Learn more →Tài nguyên lowpoly
Đặt model_type là 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ô hình đã hoàn thành thành một tập tin 3MF đa màu sắc, 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ã sinh ra.
- Duyệt toàn bộ tham chiếu API cho mọi endpoint.
- Kiểm tra Giá, Giới hạn tỷ lệ, và Lỗi trước khi bạn đưa vào sản xuất.
- Theo dõi nhật ký thay đổi để biết các cập nhật và sửa lỗi.
- Có ý kiến 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 được nghe từ bạn!