Meshy API を通じて 3D アセットを生成すると、各タスクの結果は一時的に Meshy のサーバーに保存されます。保存期間を理解しておくことで、統合の計画を立てやすくなり、出力の有効期限が切れる前にダウンロードできます。
タスクタイプ別のアセット保存期間
保存期間はタスクタイプによって異なります：
タスクタイプ | 保存期間 |
Text to 3D | タスク完了後 3 日間 |
Image to 3D | タスク完了後 3 日間 |
リギング | タスク完了後 2 か月間 |
Text to 3D および Image to 3D
タスクとその出力（モデルファイル、プレビュー画像、テクスチャ）は、タスク完了時点から 3 日間 保存されます。この期間を過ぎると、タスクおよび関連するすべてのダウンロード URL にアクセスできなくなります。
すべての API タスクのレスポンスには、タスクが削除される正確な時刻を示す expires_at フィールド（ミリ秒単位の Unix タイムスタンプ）が含まれています：
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
統合の際にはこの値を監視し、期限が切れる前にダウンロードを実行するようにしてください。
リギングタスク
リギングタスクは完了後 2 か月間 保存されます。この延長された期間により、元のリギングタスク ID を使用して、メッシュを再リギングすることなく、同じリグ済みキャラクターに新しいアニメーションを追加し続けることができます。
既存のリグにアニメーションを追加するには、2 か月間の保存期間内であればいつでも、アニメーションリクエストでリギングタスク 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. リギングタスクの有効期限が切れた後でも、キャラクターに新しいアニメーションを追加できますか？
リギングタスクは 2 か月間利用可能で、アニメーションを追加し続けるための十分な期間が設けられています。リギングタスクの有効期限が切れている場合（2 か月より前の場合）、元のメッシュを再リギングする必要があります。
注意：Meshy は、別々のリギング実行間でスケルトンの互換性を保証するものではありません。