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.

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