Video GenerationRunway
Runway Gen-4 Turbo
Generate 720p videos from text or images using the Runway Gen-4 Turbo model with fast generation times.
POST /v2/videos/generate — model: "runway-gen4-turbo"
Generate 720p videos from text prompts or input images. When an image is provided, the model operates in image-to-video mode; otherwise it generates from text only. Supports aspect ratio control and seed for reproducibility.
See Video Generation overview for common request fields, response format, and error codes.
Model-specific parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
runwayParams.image | string | No | — | Image URL for image-to-video mode |
runwayParams.duration | number | No | 5 | Video duration in seconds: 5 or 10 |
runwayParams.aspect_ratio | string | No | — | Aspect ratio: "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" |
runwayParams.seed | integer | No | — | Random seed for reproducible generation |
Credit cost
| Variant | Credits |
|---|---|
5s | 8 |
10s | 15 |
Code examples
curl -X POST https://api.apiframe.ai/v2/videos/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a futuristic city skyline at sunset with flying cars",
"model": "runway-gen4-turbo",
"runwayParams": {
"duration": 5,
"aspect_ratio": "16:9"
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/videos/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "a futuristic city skyline at sunset with flying cars",
"model": "runway-gen4-turbo",
"runwayParams": {
"duration": 5,
"aspect_ratio": "16:9",
},
},
)
print(response.json())const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
prompt: "a futuristic city skyline at sunset with flying cars",
model: "runway-gen4-turbo",
runwayParams: {
duration: 5,
aspect_ratio: "16:9",
},
}),
});
console.log(await response.json());body := `{
"prompt": "a futuristic city skyline at sunset with flying cars",
"model": "runway-gen4-turbo",
"runwayParams": {
"duration": 5,
"aspect_ratio": "16:9"
}
}`
req, _ := http.NewRequest("POST", "https://api.apiframe.ai/v2/videos/generate",
strings.NewReader(body))
req.Header.Set("X-API-Key", "afk_your_api_key_here")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)Image-to-video
curl -X POST https://api.apiframe.ai/v2/videos/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "the scene comes alive with gentle motion and dynamic lighting",
"model": "runway-gen4-turbo",
"runwayParams": {
"image": "https://example.com/photo.jpg",
"duration": 10
}
}'Try it
POST
/v2/videos/generateTry it