api
Shots
The shot object, and the endpoint that changes exactly one of them.
Last updated 2026-07-10
The shot object
Each shot in a sequence outcome carries its role in the arc (hook, development, payoff), narrative and emotional purpose, camera spec, routed model, attached continuity reference ids, render result, and provenance record. It is a view of the Canonical Shot Object.
refine_shot
request
{
"original_intent": "15 second trail shoe launch film",
"shot_id": "shot_3",
"change": "golden hour backlight instead of overcast"
}The change applies to the named shot's canonical object in the channel it affects; continuity references stay locked and other shots are untouched by construction. See channel-scoped refinement.
Errors
| Status | Meaning |
|---|---|
| 400 | Missing original_intent, shot_id, or change |
| 422 (blocked) | The change ran into safety policy; nothing spent |