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.

See the request lifecycleRead the API docs Works with any HTTP client

Open-source reference apps

See the API at work

Start with a complete product flow, then adapt the interface, agent behavior, and render handoff to your own use case.

Browse on GitHub
Magic House Tour interface for uploading listing photos and generating a property video

Real estate video

Magic House Tour

Convert static listing photos into a narrated, captioned listing video.

Chat Edit interface showing a video editing conversation and selectable templates

Conversational editing

Chat Edit

A template-based video chatbot agent for uploading footage, directing an edit, and reviewing the result in conversation.

Render integration

Remotion Handoff

Turn a Scrambo render handoff into a verified H.264/AAC video with a local Remotion renderer.

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

Request REST API accessRead the API docs

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.