FAfal
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.

Required permissions: assets:write. Key presets that include them: API, SERVERLESS, FULL. See key permissions.

post/assets/characters

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/assets/characters
  • Auth
    API key in header Authorization

Headers

Idempotency-Keystring

Optional idempotency key for safe request retries

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

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 operation across all 12 revisions of this API.