アセットの取得
GET/v1/assets/{id}
アセット1件の状態と結果を取得します。すべての非同期ジョブでポーリングするエンドポイントです。
作成リクエスト(生成、リメッシュ、テクスチャ、アニメート)のあとにこのエンドポイントを呼び出すと、ジョブが待機中から成功へ進む様子を確認できます。またはポーリングを一切行わず、Webhookで準備が整った瞬間に同じオブジェクトを受け取ることもできます。
リクエスト
request
curl https://api.picoberry.ai/v1/assets/019… \
-H "Authorization: Bearer pb_live_xxx"requests.get(f"{BASE}/v1/assets/{id}", headers=headers).json()["data"]const asset = (await (await fetch(`${BASE}/v1/assets/${id}`, { headers })).json()).data;タスクの状態
taskStatusは分岐の基準となる整数で、progress(0–100)は実行中のジョブの進捗を表します。
0 · 待機中 受け付け済み、開始待ち1 · 処理中 生成を実行中2 · 成功
files の準備完了3 · 失敗 クレジットは返金済み — errorCategory を確認レスポンス
response · succeeded
{ "success": true, "data": {
"id": "019…",
"name": "treasure chest",
"type": "model_3d",
"taskStatus": 2,
"progress": 100,
"createdAt": "2026-08-05T09:12:00.000Z",
"files": {
"model": "https://…signed.glb",
"thumbnail": "https://…signed.png",
"hasTextures": true
},
"nsfw": false,
"license": "private"
} }アセットオブジェクト
| フィールド | 説明 |
|---|---|
| id string | アセットの id。 |
| name · description string | ラベル、および生成に使用したプロンプトやメモ。 |
| type string | アセットの種類 — 例: model_3d、image。 |
| taskStatus integer | 0 / 1 / 2 / 3 — 上記のタスクの状態を参照。 |
| progress integer | ジョブの実行中は 0–100。 |
| createdAt string | ISO 8601 の作成タイムスタンプ。 |
| files object | 成功時に格納される署名付き結果URL — model、preview、image、thumbnail、textures[]、および hasTextures フラグ。 |
| errorCategory · errorDetail string | 失敗したジョブ(taskStatus: 3)にのみ存在 — 失敗の種類と、サニタイズされた詳細。 |
| nsfw boolean | アセットがコンテンツフィルターでフラグされたかどうか。 |
| license string | アセットの使用権。 |
署名付きURLは期限切れになります
files.* のURLは短命です — 長期間保存せず、すぐにダウンロードまたはコピーしてください。