> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keyframe.art/llms.txt
> Use this file to discover all available pages before exploring further.

# References

> Use images, videos, audio, and documents to guide movie generation.

# References

References are durable inputs. Upload once, then attach by ID.

## Reference roles

| Role        | Use                                                            |
| ----------- | -------------------------------------------------------------- |
| `character` | Preserve a person, mascot, or fictional character.             |
| `product`   | Preserve the appearance of a product or object.                |
| `location`  | Preserve a room, set, venue, or environment.                   |
| `style`     | Guide art direction, color, lensing, or motion style.          |
| `audio`     | Provide music, voice, ambience, or sound-design direction.     |
| `document`  | Provide scripts, briefs, brand guidelines, or product details. |
| `other`     | Attach additional context that does not fit another role.      |

## Upload guidance

Use clean source media. For products and characters, avoid crops, compression, filters, and text overlays.

## Prompting with references

Movie prompts describe the outcome. Reference descriptions explain how each file should be used.

```json theme={null}
{
  "reference_id": "ref_abc123",
  "role": "location",
  "description": "Use this studio as the main interior location. Preserve the concrete floor and curved back wall."
}
```