Skip to main content

​
References

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

​
Reference roles

RoleUse
characterPreserve a person, mascot, or fictional character.
productPreserve the appearance of a product or object.
locationPreserve a room, set, venue, or environment.
styleGuide art direction, color, lensing, or motion style.
audioProvide music, voice, ambience, or sound-design direction.
documentProvide scripts, briefs, brand guidelines, or product details.
otherAttach 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."
}