Skip to main content

Documentation Index

Fetch the complete documentation index at: https://fal.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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 a single asset by vector ID

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: 
Authorization: Key YOUR_API_KEY
If generated media is not appearing in Assets, check your Assets settings in the dashboard and enable the request sources you want available in the library.