Documentation menu

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.

Refine one shot | Cadenza Docs