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.
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.
Authorizations
API key must be prefixed with "Key ", e.g. Authorization: Key YOUR_API_KEY
Headers
Optional idempotency key for safe request retries
"550e8400-e29b-41d4-a716-446655440000"
Body
Character display name
1 - 255Text description used for character semantic matching
1 - 2000Reference images for the character. Prefer vector IDs or request IDs for existing fal-generated assets. Use fal-hosted image URLs only for standalone images.
1 - 20 elements1Optional @mention identifier for the character
64Optional fal-hosted cover image URL for the character
Response
Character created
Asset character