アセット

ダウンロードとエクスポート

POST/v1/assets/{id}/download

完成したアセットをGLB、FBX、OBJにエクスポートし、有効期限の短い署名付きダウンロードURLを取得します。

同期 URLを直接返しますフォーマット glb・fbx・obj

生成とは異なり、この呼び出しは同期です。エクスポートを実行し、同じレスポンスでダウンロードURLを返すため、ポーリングは不要です。大きなアセットや非常に精細なアセットのパッキングには時間がかかることがあるため、クライアントのタイムアウトは長めに設定してください。

パラメーター

パラメーター	説明
format必須 string	エクスポートフォーマット。`glb`、`fbx`、`obj` のいずれか。
texturePreset任意デフォルト standard string	`standard` または `unity`。`unity` はUnity URP / Built-in向けにチャンネル分割マップを生成し、`.meta` サイドカーを追加します。
name任意デフォルト model string	エクスポートの基本ファイル名。最大100文字。

リクエスト

curl -X POST https://api.picoberry.ai/v1/assets/019…/download \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"format":"fbx","texturePreset":"unity"}'

requests.post(f"{BASE}/v1/assets/{id}/download", headers=headers,
    json={"format": "fbx", "texturePreset": "unity"})

await fetch(`${BASE}/v1/assets/${id}/download`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ format: "fbx", texturePreset: "unity" }) });

レスポンス

レスポンス · 200

{ "success": true, "data": {
  "url": "https://…signed",
  "format": "glb",
  "archive": false,
  "contentType": "model/gltf-binary",
  "filename": "model.glb"
} }

glb は単一ファイル・fbx / obj はバンドル glb エクスポートは単一ファイルとして返されます（archive: false）。fbx と obj はモデル + テクスチャをまとめた .zip（archive: true）として返され、texturePreset が unity のときは .meta が追加されます。

URLは有効期限が短い 署名付き url は発行後すぐに期限が切れます。速やかに取得し、期限が切れたらエクスポートを再度リクエストしてください。