Edit Video

curl https://api.tutorflow.io/v1/platform/videos/edit/{editToken}

{
  "videoRequestId": "e41a085a-e43f-4f63-92f4-9e11250f6e63",
  "platformVideoId": "e10b8286-94ad-4139-a946-3548b46f6d07",
  "title": "What Is Photosynthesis for Kids?",
  "description": null,
  "aspectRatio": "16:9",
  "visibility": "PRIVATE",
  "renderStatus": "IDLE",
  "videoKey": null,
  "thumbnailKey": null,
  "bgmAudioKey": null,
  "bgmVolume": 0.15,
  "bgmOffset": 0,
  "userNarrationScript": null,
  "slug": "what-is-photosynthesis-for-kids-d6a02f3b",
  "metadata": { "language": "en", "sceneCount": 4, "targetDurationSeconds": 30 },
  "scenes": [
    {
      "id": "uuid-1",
      "order": 0,
      "script": "Photosynthesis is how plants make their own food…",
      "displayText": null,
      "ttsAudioKey": "platform/{workspaceId}/videos/{videoId}/scenes/uuid-1/tts.mp3",
      "videoClipKey": null,
      "videoClipSource": null,
      "visualType": "image",
      "visualKey": "platform/{workspaceId}/videos/{videoId}/scenes/uuid-1/visuals/image.png",
      "visualSource": "upload",
      "remotionTemplate": "keyword",
      "keywords": ["plant", "sunlight"],
      "duration": 7.2,
      "audioOffset": 0,
      "audioDuration": 6.2,
      "videoOffset": 0,
      "videoDuration": null,
      "visualOffset": 0,
      "visualDuration": null,
      "visualFit": "cover",
      "subtitleOffset": 0,
      "subtitleDuration": 6.2,
      "subtitles": [{ "text": "Photosynthesis is how plants make their own food", "offset": 0, "duration": 3.1 }],
      "transitionOut": null,
      "transitionDuration": 1,
      "videoEffect": null,
      "visualEffect": null,
      "visualMetadata": null,
      "visualAdjustments": null,
      "visualOverlays": [],
      "metadata": null
    }
  ],
  "editToken": "2dce...",
  "editTokenExpiresAt": "2026-04-25T15:15:28.628Z",
  "shareToken": "b64a..."
}

curl -X PATCH https://api.tutorflow.io/v1/platform/videos/edit/{editToken} \
  -H "Content-Type: application/json" \
  -d '{ "title": "Updated Title", "aspectRatio": "9:16", "bgmVolume": 0.2 }'

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes \
  -H "Content-Type: application/json" \
  -d '{
    "script": "And that is how the carbon cycle returns oxygen to the atmosphere.",
    "duration": 6,
    "keywords": ["forest", "atmosphere"],
    "remotionTemplate": "keyword"
  }'

curl -X DELETE https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/{sceneId}

curl -X PUT https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/reorder \
  -H "Content-Type: application/json" \
  -d '{ "sceneIds": ["uuid-3", "uuid-1", "uuid-2", "uuid-4"] }'

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/{sceneId}/tts

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/{sceneId}/clip/search \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "sunlight on leaves" }'

[
  { "source": "pexels",  "sourceId": 7845321, "thumbnailUrl": "...", "previewUrl": "...mp4", "duration": 12 },
  { "source": "pixabay", "sourceId": 142398,  "thumbnailUrl": "...", "previewUrl": "...mp4", "duration": 8 }
]

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/{sceneId}/clip/select \
  -H "Content-Type: application/json" \
  -d '{
    "source": "pexels",
    "sourceId": 7845321,
    "previewUrl": "https://videos.pexels.com/.../clip.mp4"
  }'

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/{sceneId}/clip/upload \
  -F "file=@my-clip.mp4"

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/{sceneId}/visual/image/upload \
  -F "file=@diagram.png"

curl "https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/visual/slides?search=photosynthesis"

[
  {
    "id": "slide-uuid",
    "title": "Photosynthesis Overview",
    "thumbnail": "platform/{workspaceId}/slides/{slideId}/thumbnail.png",
    "contentVersion": 4,
    "editToken": "slide-edit-token"
  }
]

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/{sceneId}/visual/slide \
  -H "Content-Type: application/json" \
  -d '{ "slideId": "slide-uuid" }'

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/{sceneId}/visual/slide/create

{
  "scene": {
    "id": "scene-uuid",
    "visualType": "slide",
    "visualKey": null,
    "visualSource": "slide",
    "visualMetadata": {
      "slideId": "slide-uuid",
      "slideEditToken": "slide-edit-token",
      "contentVersion": 1
    }
  },
  "slideId": "slide-uuid",
  "editToken": "slide-edit-token"
}

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/{sceneId}/overlays/sticker/upload \
  -F "file=@arrow.png"

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/scenes/{sceneId}/overlays/character/generate \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "friendly teacher pointing at a leaf diagram" }'

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/bgm/search \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "uplifting" }'

[
  { "id": "preset-001", "title": "Sunny Acoustic", "tags": ["uplifting", "warm"], "durationSeconds": 142, "s3Key": "..." }
]

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/bgm/select \
  -H "Content-Type: application/json" \
  -d '{ "presetId": "preset-001" }'

curl -X DELETE https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/bgm

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/sync-durations

{ "updated": 3 }

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/thumbnail \
  -F "file=@thumb.jpg"

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/render

{
  "renderStatus": "RENDERING",
  "videoKey": "platform/{workspaceId}/videos/{videoId}/rendered/photosynthesis-1dvr.mp4",
  "...": "..."
}

curl -X POST https://api.tutorflow.io/v1/platform/videos/edit/{editToken}/render/cancel