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ạn

Bốn bước để có mô hình 3D đầu tiên của bạn, sử dụng Meshy REST API.


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ở Cài đặt API từ menu API, sau đó tạo khóa của bạn


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

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.

Ảnh mèo mẫu được sử dụng làm đầu vào Ảnh sang 3D trong hướng dẫn này
Đầu vào mẫu

Yêu cầu

POST
/openapi/v1/image-to-3d
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 statusSUCCEEDED — thay thế <task_id> dưới đây bằng mã ID trả về trong bước 2.

Yêu cầu

GET
/openapi/v1/image-to-3d/:id
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": ""
  }
}

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ề

model_urls.glb
curl -L "<model_urls.glb từ phản hồi trên>" -o model.glb
Mô hình 3D kết quả được tạo ra từ ảnh mèo mẫu
Kết quả của bạ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


Các bước tiếp theo