Access

Video input guide

Video-to-video API. Start with motion. Control the change.

A source clip can be the footage you edit, a reference that guides a new shot, or the start of a continuation. Pick that job first. Then match its input rules, prompt, and billing.

Async edit requestvideo → video
{
  "model": "wan2.7-videoedit",
  "input": {
    "prompt": "Keep the timing and camera path. Change the setting to a rain-soaked neon street.",
    "media": [
      { "type": "video", "url": "https://cdn.example.com/source.mp4" }
    ]
  },
  "parameters": {
    "resolution": "1080P",
    "prompt_extend": false,
    "watermark": false
  }
}

Three different jobs

Do not call every video input an edit.

Direct editing changes the source itself. Reference generation borrows selected facts from it. Continuation adds time after it. The API fields and cost rules change with the mode.

ModeSource roleWhat it can controlExample routes
Direct editThe input clip is the footage being changed.Style, subject details, clothing, setting, action, dialogue, or camera instructions.Runway video_to_video; Wan 2.7 videoedit
Reference-to-videoThe clip guides a new generation.Subject motion, performance, camera path, pacing, or voice while a new scene is made.Wan 2.7 r2v
ContinuationThe clip supplies the story and ending frame so far.More footage after the source while keeping its ratio, motion, and visual direction.Wan 2.7 i2v continuation

Source control

Protect the timing before you change the look.

Use one short action with a clean start and end. Tell the model what the clip controls and what must remain unchanged.

Motion control board shows a source clip, directed movement, camera path, and final frame
Source motion → protected facts → requested change → reviewed result

Input rules

Validate before upload.

The same clip can pass one route and fail another. Check duration, resolution, frame rate, upload type, output limits, and billable input time before creating the task.

RouteMediaInput durationInput limitsOutputBilling
Runway Aleph 2One video2–30 secondsUp to 1080p; 30 FPS or lowerPreserves input resolution up to 1080pSee the selected model rate
Wan 2.7 videoeditExactly one video; up to four reference images2–10 seconds240–4096 px; MP4 or MOV720P or 1080P; same duration unless truncatedInput seconds + output seconds

Wan editing and reference billing

Input seconds + output seconds = total billable duration.

Wan continuation billing

The duration field means the final combined clip.

A 3-second first clip with duration set to 15 creates 12 new seconds and bills 15 total seconds.

Five-step workflow

Keep the input, prompt, task, and result tied together.

  1. 01

    Name the mode

    Choose direct edit, reference-to-video, or continuation before selecting a model.

  2. 02

    Trim the source

    Keep one clear action, remove dead time, and meet the route's duration, size, and frame-rate rules.

  3. 03

    Protect the constants

    State what must stay: timing, camera path, subject, framing, dialogue, or original sound.

  4. 04

    Direct the change

    Describe only the new style, setting, object, action, emotion, or continuation beat.

  5. 05

    Store the result

    Poll the task, download the temporary output, and record input seconds, output seconds, and final cost.

Five detailed answers

Know what the source controls.

Video input routing

Request access updates for Cre8vid video routes.

Get access updates