Scrambo
REST API · private beta

Add video agents to your product.

Fastest way to embed agents that can understand, edit, or generate videos. Build your own video products with just an API key. Scrambo handles the agent layers from end to end.

Example of what Scrambo agents can do

From an 11-minute YouTube video to a 45-second reel

The problem. 11 minutes of raw footage. The best moments are buried in the full timeline.

Open-source reference apps

See the API at work

If your app can connect to the internet, it can put Scrambo’s video agents to work. Build a chat app that edits footage, a video editor with agents alongside the timeline, or a plugin for the editor your users already love. These reference apps are starting points for what you’ll build next.

Browse on GitHub

Request lifecycle

Creating your agent session

Create a session, add media, request an edit, then choose how to deliver it. Keep the returned IDs as you move through the flow.

One session. IDs connect each request to the next.

  1. 01

    Start

    Open a workspace for one video.

    1. 1Create session
      POST/v2/sessions

      Keep sessionId

  2. 02

    Add media

    Register the file, then send its bytes.

    1. 2Declare asset
      POST/v2/sessions/{sessionId}/assets

      Keep assetId, SHA-256, size

    2. 3Upload bytes
      PUT/v2/sessions/{sessionId}/assets/{assetId}/content

      Keep upload receipt

  3. 03

    Make the edit

    Submit direction and follow the work.

    1. 4Submit turn
      POST/v2/sessions/{sessionId}/turns

      Keep requestId, operationId

    2. 5Poll progress
      GET/v2/operations/{operationId}?after={cursor}

      Keep status, latest cursor

  4. 04

    Deliver

    Choose a browser view or render handoff.

    1. 6Create snapshot
      POST/v2/sessions/{sessionId}/view-edit-snapshots

      Keep URL, operation, expiry

    2. 7Create handoff
      POST/v2/sessions/{sessionId}/render-handoffs

      Keep operationId

    3. 8Download handoff
      GET/v2/sessions/{sessionId}/render-handoffs/{handoffId}

      Keep manifest

    4. 9Close session
      POST/v2/sessions/{sessionId}/close

      Keep terminal state

Build the first integration with us

Tell us where video editing fits in your product. We’re onboarding a small group of design partners for the stateful API.