メインコンテンツへスキップ

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を取得できます。

FAQ

1. 生成したアセットが見つからないのはなぜですか?

期限内にダウンロードしなかった場合、保存期間の終了時にアセットは削除されています。削除されたアセットは復元できません。タスクを再度送信する必要があります。

2. DELETEでタスクを削除するとアップロードした画像やモデルは一緒に削除されますか?

タスクを削除すると、そのモデルやデータを含むタスクが完全に削除されます。削除は元に戻せないため、必要なものは事前にダウンロードしてください。

3. APIで生成したモデルがワークスペースに表示されないのはなぜですか?

これは想定どおりの動作です。APIで生成したアセットはMeshy Workspaceには表示されません。APIとWorkspaceではアセットのライフサイクルが別々になっています。

4. タスクURLが404エラーを返すのはなぜですか?

タスクのexpires_atの時刻を過ぎているため、アセットは削除されています。タスクを再度送信し、タスクが成功したらすぐに独自のストレージへ自動ダウンロードするよう設定してください。


関連記事

この記事は役に立ちましたか?