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 실행 간의 스켈레톤 호환성을 보장하지 않습니다.