API · Assets
List assets
Find uploaded and imported assets in the API key’s workspace.
Authentication and limits
Use a Platform Bearer API key with models:generate permission. Assets belong to the key’s workspace. Maximum file size is 20 MiB; audio and video must be at most 300 seconds. Model-specific input limits still apply. Image inputs accept PNG/JPEG/WebP. Seedance requires 300–6000 px per side and aspect ratio 0.4–2.5; MiniMax H3 requires 256–5760 px per side and aspect ratio 0.4–2.5; Wan 3.0 requires 240–8000 px per side, longest/shortest side at most 8, no PNG alpha channel, and at most 20,000,000 bytes. Model-specific checks run before quoting, even for an existing Asset. See the model parameter table for all limits. Uploads and imports do not reserve generation funds. The workspace upload allowance is 100 assets or 1 GiB in a rolling 24-hour window. Read operations do not consume that allowance.
Input schema
GET /api/v1/media/files. Query parameters are optional. Deleted assets are excluded.
| Parameter | Required | Type | Default / options | Description |
|---|---|---|---|---|
| kind | No | string | All / image | video | audio | Filter by media kind. |
| search | No | string | — | Search display names; at most 180 characters. |
| page | No | integer | 0; range 0–10000 | Zero-based page, 24 assets per page. |
curl --get "https://platform-backend.topview.ai/api/v1/media/files" -H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY" --data-urlencode "kind=image" --data-urlencode "page=0"Output schema
Each item has the same asset fields as Upload an asset. Results are ordered newest first.
| Field | Type | Description |
|---|---|---|
| data.items | array | Assets on this page. |
| data.total | integer | Total matching assets. |
| data.page | integer | Current zero-based page. |