アセット一覧
GET/v1/assets
ライブラリ内のアセットを新しい順に一覧表示します。
クエリパラメータ
| パラメータ | 説明 |
|---|---|
| page任意デフォルト1 integer | 1始まりのページ番号(≥1)。 |
| limit任意デフォルト20 integer | ページサイズ、1〜100。 |
| category任意 string | 種類でフィルタ。all、3d、image、remesh、texture、animation、palette。 |
| keyword任意 string | アセット名の部分文字列一致、最大255文字。 |
リクエスト
リクエスト
curl "https://api.picoberry.ai/v1/assets?category=3d&limit=20" \
-H "Authorization: Bearer pb_live_xxx"requests.get("https://api.picoberry.ai/v1/assets", headers=headers,
params={"category": "3d", "limit": 20})await fetch(`${BASE}/v1/assets?category=3d&limit=20`, { headers });レスポンス
レスポンス · 200
{ "success": true, "data": [
{ "id": "019…", "type": "model_3d", "taskStatus": 2, "files": { "thumbnail": "https://…png" } },
{ "id": "019…", "type": "image", "taskStatus": 2, "files": { "thumbnail": "https://…png" } }
] }dataはアセットの配列で、各項目はGET /v1/assets/{id}と同じ形式です。レスポンスにはdataと併せて全体の件数も含まれるため、最後のページまで辿れます。
ページング 全体の件数を読み切るまで
pageを進め、categoryとkeywordで最初から対象を絞り込みましょう。