빠른 시작
API 키부터 생성하세요
이 가이드의 모든 요청에 필요합니다. 키 생성은 1분도 걸리지 않습니다.
API 키 생성하기Meshy REST API를 사용하여 첫 번째 3D 모델을 만드는 네 가지 단계입니다.
1API 키 받기
API 키 생성하기 — 이 화면 이후에는 다시 볼 수 없으므로 안전한 곳에 보관하세요. 모든 요청은 Authorization 헤더에 Bearer 토큰으로 인증됩니다 — 인증을 참고하세요.
보안 팁: 키를 직접 스크립트에 붙여넣지 마세요 — 환경 변수로 저장하세요: export MESHY_API_KEY="msy_...".
2첫 번째 이미지로 3D 요청하기
키를 내보내고, 이미지로 3D로 첫 번째 작업을 만듭니다. 텍스트 prompt 또는 여러 사진에서 작업하려고 합니까? 텍스트로 3D 또는 멀티 이미지로 3D를 확인하세요.
Export your key
export MESHY_API_KEY="<your-api-key>"
이를 터미널(macOS의 Terminal, Windows의 Command Prompt 또는 PowerShell)에서 실행하세요 — 브라우저에서는 하지 마세요.
아래의 모든 예제는 이 사진을 사용합니다 — 다른 것을 시도하려면 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작업 상태 확인하기
요청은 즉시 작업 ID를 반환합니다. <task_id>를 2단계에서 반환된 ID로 대체하여 동일한 엔드포인트를 계속하여 상태가 SUCCEEDED인지 확인하세요.
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": ""
}
}
4모델 다운로드하기
위 응답의 model_urls에서 모델을 가져오세요. 각 포맷(GLB, FBX, OBJ, USDZ, STL)은 서명된, 시간 제한 있는 URL입니다 — 명령줄을 건너뛰고 브라우저 주소 창에 URL을 직접 붙여넣어 다운로드할 수 있습니다.
Download
curl -L "<model_urls.glb from the response above>" -o model.glb
파일은 엔터프라이즈 플랜이 아닌 경우 3일 동안 보존됩니다 — 에셋 보존을 참고하세요.
모든 것을 한데 모으기
하나의 스크립트로 모든 것을 처리하는 것을 선호하십니까 — 생성, 폴링, 다운로드?
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. 작업 생성하기
const { data: created } = await axios.post(
'https://api.meshy.ai/openapi/v1/image-to-3d',
{ image_url: imageUrl },
{ headers },
);
const taskId = created.result;
// 2. 완료될 때까지 폴링하기
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. 결과 다운로드하기
const { data: model } = await axios.get(task.model_urls.glb, { responseType: 'arraybuffer' });
fs.writeFileSync('model.glb', model);
console.log('Saved model.glb');
일반 워크플로우 탐색
게임 준비 완료 캐릭터
Unity 또는 Unreal에서 애니메이션을 준비할 수 있도록 인체형 메시에 스켈레톤을 장착하세요.
Learn more →로우폴리 에셋
깔끔하고 게임 준비 완료된 메시를 위해 이미지로 3D에서 model_type을 lowpoly로 설정하세요.
3D 프린트 모델
완료된 모델을 멀티 컬러 3MF 파일로 변환하여 슬라이스하고 프린트할 준비를 하세요.
Learn more →