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