Video Editing

Alongside the AI models, Segmind serves a set of media editing endpoints — deterministic operations like compositing a timeline, cutting a video into clips, or pulling a still frame. There is no model involved, so they are cheap and fast, and they speak exactly the async contract you already use: POST /v2/{slug}, poll the status URL, read the result.

That means an edit is just another step in the same pipeline as the generation that produced the footage — no separate tool, no downloading and re-uploading between stages.

The endpoints

Each one bills like any other request — the jobs on this page each cost $0.0002 — and the result carries the usual metrics block with cost, remaining_credits, queue_time and total_time.

/v2/timeline — multi-track composition

One request describes a whole edit. A composition block sets the output frame, tracks holds the layers, and master controls the final encode.

{
  "composition": { "width": 1280, "height": 720, "fps": 30, "duration": "auto", "format": "mp4" },
  "tracks": [
    {
      "type": "video",
      "id": "V1",
      "clips": [
        { "source": "https://example.com/shot-a.mp4", "start": 0, "in": 0, "out": 4,
          "transition_out": { "type": "dissolve", "duration": 0.75 } },
        { "source": "https://example.com/shot-b.mp4", "start": 3.25, "in": 0, "out": 4 }
      ]
    },
    {
      "type": "text",
      "id": "T1",
      "clips": [
        { "start": 0.5, "duration": 3, "text": "Multi-track composition",
          "style": { "size": 64, "color": "#FFFFFF", "bg": "#000000AA",
                     "position": "lower-third", "animation": "fade" } }
      ]
    }
  ],
  "master": { "video": { "crf": 20 }, "audio": { "normalize": true, "target_lufs": -14 } }
}

That request renders a 1280×720, 30 fps H.264 file: two clips joined by a three-quarter-second dissolve, with a lower-third title fading in over the opening.

Track types

tracks is an ordered list. Visual tracks stack bottom to top, and every audio track sums into one mix.

Every clip shares the same timing fields: start places it on the timeline, in and out trim the source, and fade_in / fade_out ramp its edges.

Composition and master

composition takes width, height, fps, format (mp4 or webm) and background. duration defaults to "auto", which resolves to the extent of the timeline. Width and height must both be even numbers. A transparent background requires format: "webm", since MP4 cannot carry an alpha channel.

master handles the finish: video.crf for encode quality, and audio.normalize with audio.target_lufs — on by default at −14 LUFS, so a mix of loud and quiet sources comes out at a consistent level without you measuring anything.

Ducking

An audio clip can duck against another track, which is the usual way to put music under a voiceover:

{ "type": "audio", "id": "A1", "clips": [
  { "source": "https://example.com/music.mp3", "start": 0, "loop": true,
    "duck": { "key_track": "A2", "amount": -12, "attack": 0.2, "release": 0.4 } }
]}

Whenever a clip on A2 is playing, this one drops by 12 dB and comes back after it.

/v2/video-split — one video into many

{ "video": "https://example.com/long.mp4", "mode": "count", "count": 3 }

mode picks how the cuts are chosen:

reencode defaults to true for frame-accurate cuts; set it to false for a faster stream copy that snaps to keyframes. output_format accepts mp4 or webm.

Reading the result

Which field holds the output follows the kind of file produced, matching the rest of the API:

{
  "status": "COMPLETED",
  "output": "https://images.segmind.com/generations/.../result.mp4",
  "video": { "url": "...", "content_type": "video/mp4", "file_size": "2488382" },
  "metrics": { "cost": 0.0002, "remaining_credits": 45.68,
               "queue_time": 0.03, "total_time": 14.8 }
}

Video jobs fill video; jobs that produce a still — video-thumbnail, video-gif-extract, image-compress — fill images[] instead. output always points at the primary file either way.

Next steps