# Generation References

Source: [Generation References](<https://pr-995-preview.chatcut.dev/docs/generation-references>)

Documentation index: [llms.txt](<https://pr-995-preview.chatcut.dev/docs/llms.txt>)

Last updated: 2026-11-19

A generation reference guides the result; it is not automatically inserted into the edit. Put each reference in the slot used by the selected model or attach it to the Agent message, then explain what it should control.

## Choose the reference path

-   **Agent request:** select **\+ → Add files** for local files, or use **Selection Mode** to add `@` references to assets, clips, time, Viewer regions, or Transcript text.
-   **Saved Characters and Products:** select **\+ → My Assets**, open **Characters** or **Products**, and choose **Use** on a card to attach it. The Agent passes a Character’s or Product’s saved photos to generation as references. See [Characters and Products](https://pr-995-preview.chatcut.dev/docs/characters-and-products).
-   **Video Gen:** open **Video settings → Input** and use the visible **First Frame**, **Last Frame**, **References**, **Image Ref**, source-video, edit, or extend slots. With **Gemini Omni 1.1 Flash**, the **Input** choices are **Frames**, **Image references**, **Edit video**, and **Extend video**.
-   **Image Gen in ChatCut Desktop:** add files with **Image references**. Use JPG, PNG, WebP, HEIC, or HEIF images under 30 MB in total; Seedream 5.5 also accepts BMP, TIFF, and GIF, up to 30 MB each. The number allowed depends on the model.
-   **Existing project media:** drag or select it from the **Media Pool** rather than uploading a duplicate when the slot supports project assets.

## Describe the job of each reference

State whether a file controls identity, wardrobe, product shape, composition, motion, camera, color, timing, audio rhythm, or only general style. Also state what may change. A reference without a role can be interpreted differently from what you intended.

## When inputs disappear

Reference types and limits belong to the selected model and mode. Switching models or changing from Generate to Edit/Extend can remove incompatible inputs. Recheck every slot, duration, resolution, and credit estimate before sending.

For exact video limits, see [Model Capability Matrix](https://pr-995-preview.chatcut.dev/docs/model-capability-matrix). For persistent project media, see [Media Pool — What is the difference between a Prompt attachment and project media?](https://pr-995-preview.chatcut.dev/docs/my-assets#what-is-the-difference-between-a-prompt-attachment-and-project-media).
