Scene Graph → Timeline mapping

The Scene Graph JSON contract is the single source of truth. The SDK transforms it into a Timeline JSON the editor and render workers consume.

Incoming Scene Graph JSON

Matches SceneWeave contractVersion 2026-05-21

Unvalidated

{
  "contractVersion": "2026-05-21",
  "projectId": "proj_coffee_ad_001",
  "projectName": "Coffee Brand Ad",
  "sceneId": "scene_01",
  "shotId": "shot_01_A",
  "duration": 5,
  "fps": 24,
  "resolution": {
    "width": 1920,
    "height": 1080
  },
  "video": {
    "assetId": "asset_video_001",
    "url": "/mock/coffee-ad-shot.mp4",
    "prompt": "A young professional taking the first sip of coffee at sunrise"
  },
  "dialogue": {
    "character": "Narrator",
    "text": "Start your morning with clarity.",
    "emotion": "warm",
    "language": "English",
    "accent": "Neutral English"
  },
  "subtitle": {
    "text": "Start your morning with clarity.",
    "style": "cinematic_bottom"
  },
  "brand": {
    "name": "BeanCraft Coffee",
    "placement": "coffee cup visible in foreground"
  }
}

Field mapping

Every Scene Graph field resolves to a concrete SDK surface.

video→Video Track

Track 1 · 0s → 5s

dialogue→Voice Generation Panel

Narrator · warm

subtitle→Subtitle Track

Cinematic bottom style

brand→Shot Metadata

BeanCraft Coffee

duration→Timeline Length

5 sec workflow

resolution→Preview Canvas

1920 × 1080

video.prompt→Regeneration Context

AI shot guidance for re-generation

Run validate() to confirm field mapping.