본문 바로가기

Meshy는 API 생성 에셋을 얼마나 보관하나요?

Meshy API 에셋 보관 및 다운로드 가이드

목차

Meshy API를 통해 3D 에셋을 생성하면 각 작업과 그 결과물은 Meshy 서버에 일정 기간 동안만 보관됩니다. 보관 기간은 작업 유형이 아니라 계정 요금제에 따라 달라집니다. 결과물이 만료되기 전에 다운로드하세요.

요금제별 에셋 보관 기간

요금제

보관 기간

Pro, Premium, Ultra

3일

Studio

14일

Enterprise

영구 보관

보관 기간은 모델 파일, 미리보기 이미지, 텍스처 등 결과물을 포함한 모든 API 작업 유형에 적용됩니다. 기간이 종료되면 해당 작업과 모든 다운로드 URL이 삭제되며 복구할 수 없습니다.

요금제 비교는 요금제 페이지에서 확인할 수 있습니다.

작업 만료 시점 확인

모든 API 작업 응답에는 작업이 삭제되는 정확한 시점을 나타내는 expires_at 필드(밀리초 단위 Unix 타임스탬프)가 포함됩니다:

{
  "id": "01abc123-...",
  "status": "SUCCEEDED",
  "expires_at": 1777029052743,
  "result": {
    "model_urls": { ... }
  }
}

연동 과정에서 이 값을 모니터링하고, 만료 전에 출력물을 다운로드하세요.

에셋 다운로드

  • 즉시 다운로드하세요. 작업이 SUCCEEDED 상태가 되면 바로 출력 파일(GLB, FBX, OBJ 등)을 자체 저장소에 다운로드하세요.

  • 작업 목록 엔드포인트를 사용하세요. 각 작업 유형의 목록 엔드포인트로 최근 작업 ID와 출력 URL을 조회할 수 있습니다.

자주 묻는 질문

1. 생성한 에셋을 찾을 수 없는 이유는 무엇인가요?

제때 다운로드하지 않았다면 보관 기간이 끝나면서 에셋이 삭제된 것입니다. 삭제된 에셋은 복구할 수 없으므로 작업을 다시 제출해야 합니다.

2. 작업에 DELETE를 호출하면 업로드한 이미지와 모델도 삭제되나요?

작업을 삭제하면 해당 작업과 그 모델 및 데이터가 영구적으로 삭제됩니다. 삭제는 되돌릴 수 없으므로 필요한 것은 먼저 다운로드하세요.

3. API로 생성한 모델이 워크스페이스에 표시되지 않는 이유는 무엇인가요?

정상적인 동작입니다. API로 생성한 에셋은 Meshy 워크스페이스에 표시되지 않습니다. API와 워크스페이스는 에셋 수명 주기를 별도로 관리합니다.

4. 작업 URL이 404를 반환하는 이유는 무엇인가요?

작업의 expires_at 시간이 지나 에셋이 삭제되었기 때문입니다. 작업을 다시 제출하고, 작업이 성공하는 즉시 자체 스토리지로 자동 다운로드되도록 설정하세요.


관련 문서

이 답변이 도움이 되었나요?