Apply remix actions

Layer edits onto a project after the video is built.

Remix actions are edits applied to a project after a workflow builds it: background music, a logo overlay, caption changes, transitions, or open-ended natural-language edits. This step is optional. Skip ahead to export if your video is ready as-is.

You can apply remix actions two ways:

  • In the same workflow call, by passing a remixActions array (each runs after the video is built).
  • On an existing project, by calling POST /v1/projects/{projectId}/remix.

Apply to an existing project

Send an ordered list of edits. Each runs asynchronously as its own remix action, and the response returns one remix action id per edit in order.

1import { VideoGenClient } from "@videogen/sdk";
2
3const client = new VideoGenClient({ token: process.env.VIDEOGEN_API_KEY });
4
5const { remixActionIds } = await client.projects.remixProject({
6 projectId,
7 remixActions: [
8 { type: "SET_BACKGROUND_MUSIC", fileId: "vg_file_...", volume: 0.3 },
9 { type: "SET_LOGO", fileId: "vg_file_..." },
10 { type: "ADD_TRANSITIONS", sectionTransition: "DYNAMIC", assetTransition: "FADE" },
11 ],
12});
13
14console.log(remixActionIds);

Poll GET /v1/projects/{projectId}/remix-actions until each action’s status is terminal. Pass saveAsNewProject: true to apply the edits to a copy and leave the original untouched.

Next steps