guides
Refine one shot
Give a note like a director: one shot changes, the approved shots stay approved.
Last updated 2026-07-10
When to use it
Use refine_shot when a specific shot needs a specific change: different light, a slower camera, a tighter frame. Do not regenerate the whole sequence for a one-shot note.
Request
curl
curl -X POST https://cadenza.media/api/v1/refine_shot \
-H "Authorization: Bearer cadk_..." -H "Content-Type: application/json" \
-d '{
"original_intent": "15 second trail shoe launch film",
"shot_id": "shot_3",
"change": "golden hour backlight instead of overcast"
}'What stays stable
- Continuity references stay locked, so the subject does not change identity.
- Untouched shots are untouched by construction: the call regenerates only the named shot.
- The change is applied to the shot's canonical object in the channel it affects, then re-encoded for the routed model.
Billing implications
One refined shot bills as one shot's work, not a new project.