List your saved assets
Returns the ready assets of the key's library, one page at a time. Pass the previous page's nextCursor as cursor to continue; it is absent on the last page, and a cursor only works with the sort it came from. Filter with kind, source (comma-separated), favorite, collectionId (one collection of the key's library; collections are created and edited in the console, and an id outside this library returns 404), entityId (the images of one character) and a case-insensitive name search in q. Order with sort: recent (default, newest first), oldest, name (case-insensitive A to Z) or size (largest first).
Every item carries a stable uri (spicy://a/<id>) and a private previewUrl signed for at most 20 minutes. The uri works only in generation requests made with keys of the same workspace (any media field of a model input); nothing in this API returns a permanent or publicly reachable link, so the asset library cannot be used as file hosting. Responses are private, no-store. Listing and reading assets is limited to 60 requests per minute per account.
The key decides the library: a key created in your personal workspace reaches your personal library, and a key created in a team workspace (by any member) reaches that team's shared library. A team key never reaches anyone's personal library. What a team key may change follows the current role of the member who created it: owner and admin can save, rename and delete anything; developer can save and rename or delete only what they saved; billing and readonly can only read and use assets. If that member has left the team the key gets 403 with data.reason asset_workspace_forbidden.
Request
- Base URL: https://api.spicyapi.ai
- URL: https://api.spicyapi.ai/api/v1/assets
- Auth: HTTP bearer
Query parameters
Comma-separated list of task_output, upload and url.
Case-insensitive substring of the asset name.
Only favorites (true) or only assets that are not favorites (false).
Only assets in this collection of the same library (404 when it is not one).
Only the images of this character in the same library; an unknown id returns an empty page.
Response
One page of assets.
Changes
No recorded changes to this operation across all 1 revision of this API.