Skip to main content
The fal Platform APIs provide programmatic access to fal Assets, including:
  • Browse and search - List assets, filter by media type or source, and search with text or fal-hosted media
  • Uploads - Add media to your Assets library from API or CLI-driven workflows
  • Collections - Create manual collections and add or remove assets
  • Characters - Create reusable character collections with reference images
  • Tags and favorites - Organize assets with tags and favorite state
Use these APIs when you want generated outputs, uploaded references, and reusable creative assets to be available outside the dashboard. For generating new media, use the Model APIs, then use Assets to browse, search, and organize the media that belongs in your library. For an end-to-end example, see Using the Assets API. For browser workflows, see the fal Assets guide.

​
Available Operations

The Platform APIs provide the following endpoints for fal Assets:

Browse Assets

Browse and semantically search assets across media, uploads, favorites, collections, tags, and character references

Upload Asset

Upload fal-hosted media into your Assets library

Get Asset

Retrieve details for an asset in your library

Favorite Asset

Favorite an asset by vector ID or request ID

​
Collections

List Collections

List asset collections in your library

Create Collection

Create a collection for organizing related assets

Browse Collection Assets

Browse assets inside a collection

Add Asset to Collection

Add an asset to a collection by vector ID or request ID

​
Characters

List Characters

List character collections in your library

Create Character

Create a reusable character from descriptions and reference images

Get Character

Retrieve a character collection

Favorite Character

Mark a character collection as a favorite

​
Tags

List Tags

List tags in your Assets library

Create Tag

Create a tag for organizing assets

Set Tags for Asset

Replace the full tag set for an asset

Assign Tag

Assign a tag to an asset by vector ID or request ID

​
Authentication

Assets endpoints require an API key in the Authorization header:
Assets must be enabled for the account associated with your API key. If generated media is missing, check the selected account and which request sources its configuration includes. See Access and availability.