Compatibility Format
Runway Video2video
Use DeerAPI to call the Runway Video2video endpoint with request details, response details, examples, and an OpenAPI playground.
POST
/
runway
/
pro
/
video2video
cURL
curl https://api.deerapi.com/runway/pro/video2video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DEERAPI_KEY" \
-d '{
"callback_url": "https://your-server.com/callback",
"video": "https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4",
"model": "gen4",
"prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
"options": {
"seconds": 5,
"structure_transformation": 0.5,
"flip": true
}
}'import os
import requests
url = "https://api.deerapi.com/runway/pro/video2video"
headers = {
"Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
"Content-Type": "application/json",
}
payload = {
"callback_url": "https://your-server.com/callback",
"video": "https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4",
"model": "gen4",
"prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
"options": {
"seconds": 5,
"structure_transformation": 0.5,
"flip": true
}
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())const response = await fetch("https://api.deerapi.com/runway/pro/video2video", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"callback_url": "https://your-server.com/callback",
"video": "https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4",
"model": "gen4",
"prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
"options": {
"seconds": 5,
"structure_transformation": 0.5,
"flip": true
}
}),
});
console.log(await response.json());<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.deerapi.com/runway/pro/video2video",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'callback_url' => 'https://your-server.com/callback',
'video' => 'https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4',
'model' => 'gen4',
'prompt' => 'A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.',
'options' => [
'seconds' => 5,
'structure_transformation' => 0.5,
'flip' => true
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.deerapi.com/runway/pro/video2video"
payload := strings.NewReader("{\n \"callback_url\": \"https://your-server.com/callback\",\n \"video\": \"https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4\",\n \"model\": \"gen4\",\n \"prompt\": \"A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.\",\n \"options\": {\n \"seconds\": 5,\n \"structure_transformation\": 0.5,\n \"flip\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.deerapi.com/runway/pro/video2video")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"callback_url\": \"https://your-server.com/callback\",\n \"video\": \"https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4\",\n \"model\": \"gen4\",\n \"prompt\": \"A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.\",\n \"options\": {\n \"seconds\": 5,\n \"structure_transformation\": 0.5,\n \"flip\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.deerapi.com/runway/pro/video2video")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"callback_url\": \"https://your-server.com/callback\",\n \"video\": \"https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4\",\n \"model\": \"gen4\",\n \"prompt\": \"A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.\",\n \"options\": {\n \"seconds\": 5,\n \"structure_transformation\": 0.5,\n \"flip\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"msg": "Request accepted.",
"data": {
"task_id": "221c136d-7888-43c3-acd3-1fcc90d51cfd",
"state": "",
"status": "0",
"prompt": "",
"prompt_en": null,
"video_url": null,
"raw_video_url": null,
"poster": null,
"last_frame": null,
"msg": null,
"create_time": "0",
"update_time": "0"
},
"exec_time": 0
}Overview
Use this endpoint to call the Runway Video2video workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.Before you start
Use the DeerAPI base URL and pass your API Key in theAuthorization header:
https://api.deerapi.com
Authorization: Bearer $DEERAPI_KEY
Model selection
Choose a current model ID from the live pricing page. Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.Implementation notes
- Use the OpenAPI playground for the exact request fields accepted by this endpoint.
- Keep API Keys on the server side when you build production applications.
- Log the request ID from failed calls so support can investigate the request.
- Retry
429,500, and503responses with exponential backoff.
Authorizations
Use a DeerAPI API Key as a Bearer token.
Headers
Body
application/json
Use this field according to the endpoint schema.
Use this field according to the endpoint schema.
Use this field according to the endpoint schema.
Use this field according to the endpoint schema.
Show child attributes
Show child attributes
⌘I
cURL
curl https://api.deerapi.com/runway/pro/video2video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DEERAPI_KEY" \
-d '{
"callback_url": "https://your-server.com/callback",
"video": "https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4",
"model": "gen4",
"prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
"options": {
"seconds": 5,
"structure_transformation": 0.5,
"flip": true
}
}'import os
import requests
url = "https://api.deerapi.com/runway/pro/video2video"
headers = {
"Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
"Content-Type": "application/json",
}
payload = {
"callback_url": "https://your-server.com/callback",
"video": "https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4",
"model": "gen4",
"prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
"options": {
"seconds": 5,
"structure_transformation": 0.5,
"flip": true
}
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())const response = await fetch("https://api.deerapi.com/runway/pro/video2video", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"callback_url": "https://your-server.com/callback",
"video": "https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4",
"model": "gen4",
"prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
"options": {
"seconds": 5,
"structure_transformation": 0.5,
"flip": true
}
}),
});
console.log(await response.json());<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.deerapi.com/runway/pro/video2video",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'callback_url' => 'https://your-server.com/callback',
'video' => 'https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4',
'model' => 'gen4',
'prompt' => 'A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.',
'options' => [
'seconds' => 5,
'structure_transformation' => 0.5,
'flip' => true
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.deerapi.com/runway/pro/video2video"
payload := strings.NewReader("{\n \"callback_url\": \"https://your-server.com/callback\",\n \"video\": \"https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4\",\n \"model\": \"gen4\",\n \"prompt\": \"A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.\",\n \"options\": {\n \"seconds\": 5,\n \"structure_transformation\": 0.5,\n \"flip\": true\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.deerapi.com/runway/pro/video2video")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"callback_url\": \"https://your-server.com/callback\",\n \"video\": \"https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4\",\n \"model\": \"gen4\",\n \"prompt\": \"A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.\",\n \"options\": {\n \"seconds\": 5,\n \"structure_transformation\": 0.5,\n \"flip\": true\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.deerapi.com/runway/pro/video2video")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"callback_url\": \"https://your-server.com/callback\",\n \"video\": \"https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4\",\n \"model\": \"gen4\",\n \"prompt\": \"A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.\",\n \"options\": {\n \"seconds\": 5,\n \"structure_transformation\": 0.5,\n \"flip\": true\n }\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"msg": "Request accepted.",
"data": {
"task_id": "221c136d-7888-43c3-acd3-1fcc90d51cfd",
"state": "",
"status": "0",
"prompt": "",
"prompt_en": null,
"video_url": null,
"raw_video_url": null,
"poster": null,
"last_frame": null,
"msg": null,
"create_time": "0",
"update_time": "0"
},
"exec_time": 0
}