Skip to main content
The media library stores images, videos, and files once so you can reuse them across your site. AI media commands describe the result you want; Fimo chooses the generation route and returns a normal library asset.

​
Upload existing files

The JSON response wraps the asset in data. Keep .data.id when attaching it to a media field, or .data.url for a direct public URL.

​
Generate and transform images

Repeat --images when an edit needs multiple references. Run any task with --help for the flags and limits supported by your installed CLI.

​
Generate and transform video

To generate from an image, add --image <asset-id-or-url> to fimo video generate. Add --loop to return the final frame to that same image. Loops require an image, use a duration from 3 to 20 seconds, and cannot include generated audio.

​
Choose quality

Tasks that support --quality accept three stable choices: Fimo owns the underlying routing. Your commands stay stable as the internal routes improve.

​
Preview cost without generating

Add --dry-run to validate the task inputs and return a cost estimate without creating an asset or spending credits:

​
Name and organize the result

Every task accepts --name and --parent:
The response includes the asset, task, quality when applicable, credits, and USD cost. When an agent generates an image for a page or content entry, it can store contextual alt text and an optional caption with the asset. Fimo preserves supplied values and uses asset analysis only for metadata that is still missing. An empty alt text is preserved for decorative images.

​
Need endpoint-level control?

Task commands are the default. If you explicitly need a media endpoint that is not covered by a task, enable the optional Fal catalog. See Fal media catalog.

​
Browse and open assets

Folder management is available through fimo assets create-folder, fimo assets move, and fimo assets delete.

​
What’s next

Content & CMS

Attach media to schema fields.

Framework support

Render media with <Image> and <Video>.

Media library in Studio

Manage media visually.