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

> URL: https://help.meshy.ai/ko/articles/15643844-how-long-does-meshy-keep-api-generated-assets
> Language: ko
> Last updated: 2026-09-09T10:13:54Z

Meshy API를 통해 3D 에셋을 생성하면 각 작업의 결과는 일시적으로 Meshy 서버에 저장됩니다. 보관 기간을 이해하면 통합 작업을 계획하는 데 도움이 되며, 에셋이 만료되기 전에 출력물을 다운로드할 수 있습니다.

## 작업 유형별 에셋 보관 기간

보관 기간은 작업 유형에 따라 다릅니다:

| Task Type   | Retention Period |
| ----------- | ---------------- |
| Text to 3D  | 작업 완료 후 3일       |
| Image to 3D | 작업 완료 후 3일       |
| Rigging     | 작업 완료 후 2개월      |

### Text to 3D 및 Image to 3D

작업과 그 출력물 — 모델 파일, 미리보기 이미지, 텍스처 — 은 작업이 완료된 시점부터 **3일** 동안 보관됩니다. 이 기간이 지나면 해당 작업과 관련된 모든 다운로드 URL에 더 이상 접근할 수 없습니다.

모든 API 작업 응답에는 작업이 정확히 언제 삭제될지를 나타내는 `expires_at` 필드(밀리초 단위의 Unix 타임스탬프)가 포함되어 있습니다:

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

통합 과정에서 이 값을 모니터링하고, 만료되기 전에 다운로드를 실행하세요.

### Rigging 작업

Rigging 작업은 완료 후 **2개월** 동안 보관됩니다. 이 긴 보관 기간 덕분에 원본 rig 작업 ID를 사용하여 동일한 리깅된 캐릭터에 새 애니메이션을 계속 추가할 수 있으며, 메시를 다시 리깅할 필요가 없습니다.

기존 rig에 애니메이션을 적용하려면 2개월의 보관 기간 내 언제든지 애니메이션 요청에서 rig 작업 ID를 참조하면 됩니다.

## 에셋 가져오기

API로 생성한 에셋이 만료되기 전에 접근하려면:

- **즉시 다운로드하세요.** 작업이 `SUCCEEDED` 상태에 도달하면 즉시 출력 파일(GLB, FBX, OBJ 등)을 자체 스토리지에 다운로드하세요.

- **작업 목록 엔드포인트를 활용하세요.** Text to 3D 또는 Image to 3D 목록 API 엔드포인트를 통해 최근 작업 ID와 출력 URL을 가져올 수 있습니다.

## FAQ

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

이는 정상적인 동작입니다. API로 생성한 에셋은 *Meshy 워크스페이스 UI에 표시되지 않습니다*. 이는 의도된 설계로, API와 워크스페이스는 서로 다른 만료 규칙을 가진 별도의 에셋 수명 주기를 갖습니다.

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

작업의 `expires_at` 타임스탬프가 지났다면, 해당 에셋은 Meshy 서버에서 삭제된 것입니다. 생성 작업을 다시 제출해야 합니다. 앞으로 이런 일을 방지하려면, 작업이 성공하는 즉시 자체 스토리지로 자동 다운로드되도록 설정하세요.

**3. rig 작업이 만료된 후에도 캐릭터에 새 애니메이션을 추가할 수 있나요?**

Rigging 작업은 2개월 동안 이용할 수 있으므로, 애니메이션을 계속 추가할 수 있는 넉넉한 기간이 제공됩니다. rig 작업이 만료된 경우(2개월 경과) 원본 메시를 다시 리깅해야 합니다.

참고: Meshy는 서로 다른 rigging 실행 간의 스켈레톤 호환성을 보장하지 않습니다.