Assets

Create asset character

Create an asset character for the authenticated user's fal Assets library. Prefer vector IDs or request IDs in reference_images for existing fal-generated assets; use fal-hosted image URLs only for standalone images. Unresolved ID references are materialized before character state is added.

post/assets/characters

Headers

Idempotency-Keystring

Optional idempotency key for safe request retries

Example:550e8400-e29b-41d4-a716-446655440000

Optional idempotency key for safe request retries

Request body

namestring required

Character display name

identifierstring nullable

Optional @mention identifier for the character

descriptionstring required

Text description used for character semantic matching

reference_imagesstring[] required

Reference images for the character. Prefer vector IDs or request IDs for existing fal-generated assets. Use fal-hosted image URLs only for standalone images.

cover_image_urlstring uri nullable

Optional fal-hosted cover image URL for the character

Response

Character created

Changes

No recorded changes to this endpoint across all 2 revisions of this API.