Sign in
Start generating

Video to video

This endpoint will start a new task to generate a video from a video.

post/v1/video_to_video

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Request body

OR
OR
OR
OR
OR
OR

Example request

{
  "keyframes": [
    {
      "uri": "https://example.com/image.jpg"
    }
  ],
  "videoUri": "https://example.com/video.mp4"
}

Response

The task that was created.

idstring uuid required

The ID of the task that was created. Use this to retrieve the task later.

Changes

Changed in 20 of the 54 revisions of this API.8940

  • efc9e5abc4d01See the full diff
    • ○

      added the new sdr_rec709_10bit enum value to the request property oneOf[subschema #1]/outputFormat

      request-property-enum-value-added

  • 3f3a4647d82f6See the full diff
    • ○

      added the new 1080:1920 enum value to the request property oneOf[subschema #7: seedance2_5]/ratio

      request-property-enum-value-added

    • ○

      added the new 1248:1664 enum value to the request property oneOf[subschema #7: seedance2_5]/ratio

      request-property-enum-value-added

    • ○

      added the new 1440:1440 enum value to the request property oneOf[subschema #7: seedance2_5]/ratio

      request-property-enum-value-added

    • ○

      added the new 1664:1248 enum value to the request property oneOf[subschema #7: seedance2_5]/ratio

      request-property-enum-value-added

    • ○

      added the new 1920:1080 enum value to the request property oneOf[subschema #7: seedance2_5]/ratio

      request-property-enum-value-added

    • ○

      added the new 2206:946 enum value to the request property oneOf[subschema #7: seedance2_5]/ratio

      request-property-enum-value-added

  • 73a12c23285c13See the full diff
    • ▲

      removed subschema #1 from the request body oneOf list

      request-body-one-of-removed

    • ○

      added subschema #1 subschema #2: hailuo3 subschema #7: seedance2_5 to the request body oneOf list

      request-body-one-of-added

    • ○

      added the non-success response with the status 400

      response-non-success-status-added

    • ○

      added the required property estimatedCost to the response with the 200 status

      response-required-property-added

  • e7d9a59ac7b011See the full diff
    • ▲

      removed subschema #1 subschema #2 from the oneOf[subschema #1]/keyframes/items/ request property anyOf list

      request-property-any-of-removed

    • ○

      added subschema #1 subschema #2 to the oneOf[subschema #1]/keyframes/items/ request property anyOf list

      request-property-any-of-added

  • 000c2b91e0f411See the full diff
    • ▲

      removed subschema #1 from the request body oneOf list

      request-body-one-of-removed

    • ○

      added subschema #1 subschema #4: seedance2_mini subschema #5: gemini_omni_flash to the request body oneOf list

      request-body-one-of-added

  • 39fa7be65d8026See the full diff
    • ●

      removed the request property oneOf[subschema #2: seedance2]/references/items/position

      request-property-removed

    • ●

      removed the request property oneOf[subschema #3: seedance2_fast]/references/items/position

      request-property-removed

    • ○

      added the new 2160:3840 enum value to the request property oneOf[subschema #2: seedance2]/ratio

      request-property-enum-value-added

    • ○

      added the new 2880:3840 enum value to the request property oneOf[subschema #2: seedance2]/ratio

      request-property-enum-value-added

    • ○

      added the new 3840:1646 enum value to the request property oneOf[subschema #2: seedance2]/ratio

      request-property-enum-value-added

    • ○

      added the new 3840:2160 enum value to the request property oneOf[subschema #2: seedance2]/ratio

      request-property-enum-value-added

    • ○

      added the new 3840:2880 enum value to the request property oneOf[subschema #2: seedance2]/ratio

      request-property-enum-value-added

    • ○

      added the new 3840:3840 enum value to the request property oneOf[subschema #2: seedance2]/ratio

      request-property-enum-value-added

  • 02b60786c77811See the full diff
    • ▲

      removed subschema #1 subschema #2 from the oneOf[subschema #1]/keyframes/items/ request property anyOf list

      request-property-any-of-removed

    • ○

      added subschema #1 subschema #2 to the oneOf[subschema #1]/keyframes/items/ request property anyOf list

      request-property-any-of-added

  • 28f5cd401a4b13See the full diff
    • ▲

      removed subschema #1 subschema #2 from the oneOf[subschema #1]/keyframes/items/ request property anyOf list

      request-property-any-of-removed

    • ○

      added the new optional request property oneOf[subschema #1]/ratio

      new-optional-request-property

    • ○

      added subschema #1 subschema #2 to the oneOf[subschema #1]/keyframes/items/ request property anyOf list

      request-property-any-of-added

    • ○

      the request property oneOf[subschema #1]/promptText became optional

      request-property-became-optional

  • e14f3ad9667d1See the full diff
    • ○

      added the new optional request property oneOf[subschema #1]/targetAspectRatio

      new-optional-request-property

  • 410e415709b111See the full diff
    • ▲

      removed subschema #1: gen4_aleph subschema #2: aleph2 from the request body oneOf list

      request-body-one-of-removed

    • ○

      added subschema #1 to the request body oneOf list

      request-body-one-of-added