flowkit: Command for Claude Code

Generate videos with automatic scene chaining (start+end frame transitions).

Usage: /gen-chain-videos <project_id> <video_id>

This creates smooth transitions between scenes in a chain by using the NEXT scene's image as the endImage of the current scene's video, so the last frame of scene N matches the first frame of scene N+1 → seamless concat.

How chaining works

For any scene that has a CHILD in the chain (i.e. some other scene with parent_scene_id == this.id):

Scene N (chain head or middle): startImage = sceneN.image, endImage = sceneN+1.image
                                → video plays FROM sceneN.image TO sceneN+1.image (the next scene's image)

Scene N+1 (next in chain):      startImage = sceneN+1.image, endImage = sceneN+2.image (if N+2 exists)
                                → continues the chain

Last scene in chain (no child): startImage = lastScene.image, NO endImage
                                → plain frame_2_video, no chained transition

Key invariant: at the cut between two consecutive chain scenes, sceneN.video.last_frame == sceneN+1.image == sceneN+1.video.first_frame → concat is seamless.

The endImage is the CHILD scene's image (the next scene's image_media_id), NOT the parent's. Chain heads (ROOT scenes that have a child) DO need an endImage; only chain tails (last scene in chain) and standalone ROOT scenes leave endImage null.

Step 1: Pre-check

# All scene images must be ready with UUID media_ids
curl -s "http://127.0.0.1:8100/api/scenes?video_id=<VID>"

ABORT if any scene is missing ${ori}_image_media_id (UUID).

Step 2: Set up end_scene_media_ids for chaining

For each scene that has a CHILD in the chain (i.e. some other scene's parent_scene_id == this.id), set its ${ori}_end_scene_media_id to that child scene's ${ori}_image_media_id:

curl -X PATCH http://127.0.0.1:8100/api/scenes/<SID> \
  -H "Content-Type: application/json" \
  -d '{"${ori}_end_scene_media_id": "<child_scene_image_media_id>"}'