Assets

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.

get/api/v1/assets

Request

  • Base URL: https://api.spicyapi.ai
  • URL: https://api.spicyapi.ai/api/v1/assets
  • Auth: HTTP bearer

Query parameters

kind'image' | 'video' | 'audio'
sourcestring

Comma-separated list of task_output, upload and url.

qstring

Case-insensitive substring of the asset name.

favoriteboolean

Only favorites (true) or only assets that are not favorites (false).

collectionIdstring

Only assets in this collection of the same library (404 when it is not one).

entityIdstring

Only the images of this character in the same library; an unknown id returns an empty page.

sort'recent' | 'oldest' | 'name' | 'size'
cursorstring
limitinteger

Response

One page of assets.

code200 required
msg'success' required
request_idstring required

Correlation identifier. Include it in support requests.

Changes

No recorded changes to this operation across all 1 revision of this API.