POST videos/create

Videos

March 5, 2026

Model Comparison: Gen-4.5 / Gen-4
Model Comparison: Kling
Model Comparison: Veo / Sora
Model Comparison: Wan
Request Headers
Request Body
Responses
Model
Examples
Try It

Unified video generation endpoint supporting multiple Runway models: Gen-4.5 gen4.5, Gen-4 gen4, Gen-4 Turbo gen4-turbo, Kling 3.0 Pro kling-3.0-pro, Kling 3.0 Standard kling-3.0-standard, Kling 2.6 Pro kling-2.6-pro, Kling 2.6 I2V kling-2.6-i2v, Veo 3.1 veo-3.1, Sora 2 sora-2, Sora 2 Pro sora-2-pro, Wan 2.6 Flash wan-2.6-flash, and Wan 2.2 Animate wan-2.2-animate.

Each model has different capabilities, duration options, aspect ratios, resolution options, and reference image support.

Accounts with a Runway Unlimited plan can set exploreMode to true to generate videos without using credits. Explore mode generations are queued at lower priority and may take significantly longer. Not all models support exploreMode — see model comparison for details. Generation takes ~10 minutes on average. Up to two generations can usually run in parallel per account. Gen-4 Turbo and Veo 3.1 are notably faster (~1–2 min).

Model Comparison: Gen-4.5 / Gen-4

Feature	Gen-4.5	Gen-4	Gen-4 Turbo
Duration	2–10s	5s, 10s	5s, 10s
aspect_ratio (T2V)	16:9	all	all
aspect_ratio (I2V)	all	all	all
Resolution	—	720p	720p
Reference images	0–1	1 (required)	1 (required)
text_prompt	optional, 5000 chars	required, 1000 chars	required, 1000 chars
seed	auto	auto	auto
audio	on (default)	—	—
exploreMode	yes	yes	yes

Model Comparison: Kling

Feature	Kling 3.0 Pro	Kling 3.0 Standard	Kling 2.6 Pro	Kling 2.6 I2V
Duration	5s, 10s, 15s	5s, 10s, 15s	5s, 10s	5s, 10s
aspect_ratio	16:9, 9:16, 1:1	16:9, 9:16, 1:1	16:9, 9:16	—
Resolution (T2V)	auto	auto	auto	—
Reference images	0–2	0–2	0–1	1 (required)
text_prompt	optional, 2500 chars	optional, 2500 chars	required, 2500 chars	required, 2500 chars
audio	on (default)	on (default)	on (default)	on (default)
endFrame	yes	yes	—	—
multishot	2–5 shots	2–5 shots	—	—
exploreMode	yes	yes	yes	yes

Model Comparison: Veo / Sora

Feature	Veo 3.1	Sora 2	Sora 2 Pro
Duration	4s, 6s, 8s	4s, 8s, 12s	4s, 8s, 12s
aspect_ratio	16:9, 9:16	16:9, 9:16	16:9, 9:16
Resolution	720p, 1080p	—	720p, 1080p
Reference images	0–2	0–1	0–1
text_prompt	optional, 5000 chars	optional, 1000 chars	optional, 1000 chars
audio	on (default)	always on	always on
endFrame	yes	—	—
exploreMode	no	yes	yes

Model Comparison: Wan

Feature	Wan 2.6 Flash	Wan 2.2 Animate
Duration	5s, 10s, 15s	auto
aspect_ratio	16:9, 9:16, 1:1	16:9, 9:16, 1:1, 4:3, 3:4
Resolution	720p, 1080p	—
Reference images	1 (required)	1 (required)
Reference video	—	1 (required)
text_prompt	required, 1500 chars	—
audio	on (default)	—
exploreMode	yes	yes

Please be aware that Runway’s moderation system analyzes your image and text prompts and may fail task with moderation message if the prompt is determined to be offensive. Runway monitors the rate and the number of moderated tasks, which may result in your account being suspended when the internal threshold is exceeded.

The account you use to upload asset(s) via POST /assets will also be used to execute the generation. Uploading an asset to a specific account ensures that generation with that asset will occur under the same account.

https://api.useapi.net/v1/runwayml/videos/create

Request Headers

Authorization: Bearer {API token}
Content-Type: application/json
# Alternatively you can use multipart/form-data
# Content-Type: multipart/form-data

API token is required, see Setup useapi.net for details.

Request Body

{
    "model": "gen4.5",
    "email": "Optional Runway API account email",
    "text_prompt": "A cinematic aerial shot of a coastal city at golden hour",
    "duration": 5,
    "aspect_ratio": "16:9",
    "exploreMode": true,
    "replyUrl": "Place your call back URL here",
    "replyRef": "Place your reference id here",
    "maxJobs": 5
}

model is required. Supported values: gen4.5, gen4, gen4-turbo, kling-3.0-pro, kling-3.0-standard, kling-2.6-pro, kling-2.6-i2v, veo-3.1, sora-2, sora-2-pro, wan-2.6-flash, wan-2.2-animate. See model comparison for details.
email is optional, if not provided API will randomly select available account.
text_prompt describes your video in detail. Required for gen4, gen4-turbo, kling-2.6-pro, kling-2.6-i2v, and wan-2.6-flash. Not supported for wan-2.2-animate. Optional for all other models. Maximum length varies by model (1000–5000 characters).
duration is optional. Default is the first supported value for the model.
- Gen-4.5: 2–10 (continuous range)
- Gen-4, Gen-4 Turbo: 5, 10
- Kling 3.0 Pro/Standard: 5, 10, 15
- Kling 2.6 Pro, Kling 2.6 I2V: 5, 10
- Veo 3.1: 4, 6, 8
- Sora 2, Sora 2 Pro: 4, 8, 12
- Wan 2.6 Flash: 5, 10, 15
- Wan 2.2 Animate: not supported (auto)
aspect_ratio is optional. Default varies by model. Available values depend on model — see model comparison.
resolution is optional. Available resolutions depend on model.
- Gen-4, Gen-4 Turbo: 720p
- Veo 3.1: 720p (default), 1080p
- Sora 2 Pro: 720p (default), 1080p
- Wan 2.6 Flash: 720p (default), 1080p
- All other models: not supported (resolution auto-selected)
audio is optional. Default true. Set to false to disable audio generation. Supported by: Gen-4.5, Kling 3.0 Pro/Standard, Kling 2.6 Pro, Kling 2.6 I2V, Veo 3.1, Wan 2.6 Flash.
seed is optional. Only supported by Gen-4.5, Gen-4, and Gen-4 Turbo (auto-generated if not provided). Valid range 1–4294967294.
imageAssetId1, imageAssetId2 are optional. Specify the assetIds of reference images. Use GET /assets/?mediaType=image to see the list of image assets. To upload a new image asset use POST /assets. Maximum number of reference images depends on model — see model comparison.
- imageAssetId1: start frame image
- imageAssetId2: end frame image (only for models supporting endFrame: Gen-4.5, Kling 3.0 Pro/Standard, Veo 3.1)
videoAssetId is optional. Specify the assetId of a reference video. Only supported by wan-2.2-animate (required). Use POST /assets to upload a video asset.
multishot_prompt_1 through multishot_prompt_5 and multishot_duration_1 through multishot_duration_5 are optional. Multi-shot parameters for creating multi-scene videos. Only supported by Kling 3.0 Pro and Kling 3.0 Standard. Each shot requires both a prompt and a duration. Minimum 2 shots, maximum 5 shots. Shot duration range: 3–12 seconds. Total duration across all shots must not exceed 15 seconds. Prompt max length: 512 characters per shot.
exploreMode is optional. Set to true if you have a Runway Unlimited plan and wish to execute relaxed generation. You are not charged credits for Explore mode generations. Not supported by veo-3.1 — will return 400 if set to true.
replyUrl is optional, if not provided value from useapi.net account will be used. Place here your callback URL. API will call the provided replyUrl once Runway task completed or failed. Maximum length 1024 characters. We recommend using sites like webhook.site to test callback URL functionality.
replyRef is optional, place here your reference id which will be stored and returned along with this Runway task response / result. Maximum length 1024 characters.
maxJobs is optional, if not provided value for referenced by image assetId account will be used. Valid range: 1–10. Runway has dynamic query capacity and guarantees that, for a given account, at least one job will run — often two, and very rarely, three. If you have a single account linked, keep adding new jobs until you receive a 429 response. Once you get a 429, wait for xx seconds or until at least one job completes, then try again. If you need to run more jobs in parallel, simply add more Runway accounts.

Responses

200 OK

Use returned taskId to retrieve task status and results using GET /tasks/taskId. The generated video can be found in the artifacts array of the task with the status SUCCEEDED.

If you specify the optional parameter replyUrl the API will call the provided replyUrl with task progress updates until the task is complete or fails.

{
    "task": {
        "id": "<uuid>",
        "name": "gen4.5 <your text prompt>",
        "image": null,
        "createdAt": "2026-03-05T10:00:00.000Z",
        "updatedAt": "2026-03-05T10:00:00.100Z",
        "taskType": "gen4.5",
        "options": {
            "name": "gen4.5 <your text prompt>",
            "text_prompt": "<your text prompt>",
            "seconds": 5,
            "seed": 12345,
            "watermark": false,
            "route": "t2v",
            "width": 1280,
            "height": 720,
            "assetGroupId": "<uuid>",
            "creationSource": "tool-mode",
            "exploreMode": true,
            "recordingEnabled": true
        },
        "status": "PENDING",
        "error": null,
        "progressText": null,
        "progressRatio": "0",
        "estimatedTimeToStartSeconds": 0,
        "artifacts": [],
        "sharedAsset": null,
        "sourceAssetId": null,
        "taskId": "user:user_id-runwayml:account_email-task:task_uuid",
        "code": 200
    }
}

400 Bad Request

{
  "error": "<Error message>",
  "code": 400
}

401 Unauthorized

{
  "error": "Unauthorized",
  "code": 401
}

412 Insufficient credits

You do not have enough credits to run this task.

{
    "error": "You do not have enough credits to run this task."
}

429 Too Many Requests

Wait in a loop for at least 10..30 seconds and retry again.

When exploreMode is true and another explore mode job is still running, the new job will not start until the current one completes. Since explore mode generations can take significantly longer, you may need to wait before retrying.

There are two possible cases for API response 429:

API query is full and can not accept new videos/create requests. Size of query defined by maxJobs optional parameter.

{
    "error": "Account <Runway account email> is busy executing <Account maxJobs> tasks",
    "runningTasks": {
        "<Runway account email>": [
            {
                "email": "<Runway account email>",
                "taskId": "user:user_id-runwayml:account_email-task:task_#1_uuid",
                "id": "<uuid>",
                "replyUrl": "<replyUrl if provided>",
                "replyRef": "<replyRef if provided>"
            }
        ]
    },
    "code": 429
}

The API received an HTTP response status 429 from Runway. Runway has dynamic query management and may limit the number of simultaneously executed tasks based on internal service load and policies.

{
    "error": "You have too many tasks running or pending. Please wait for some of them to finish before starting more."
}

Model

{ // TypeScript, all fields are optional
  taskId: string,
  id: string,
  name: string,
  image: string,
  createdAt: string,
  updatedAt: string,
  taskType: string,
  options: {
        name: string,
        text_prompt: string,
        seconds: number,
        seed: number,
        watermark: boolean,
        route: string,
        width: number,
        height: number,
        exploreMode: boolean,
        assetGroupId: string,
        creationSource: string,
        recordingEnabled: boolean
  },
  status: string,
  progressText: string,
  progressRatio: number,
  estimatedTimeToStartSeconds: number,
  artifacts: any[],
  sharedAsset: any,
  error: {
    errorMessage: string,
    reason: string,
    message: string,
    moderation_category: string,
    tally_asimov: boolean
  },
  code: number,
  replyUrl: string,
  replyRef: string
}

Examples

curl -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer …" \
     -X POST "https://api.useapi.net/v1/runwayml/videos/create" \
     -d '{"model": "gen4.5", "text_prompt": "A cinematic aerial shot of a coastal city at golden hour", "duration": 5}'

const model = "gen4.5";
const text_prompt = "A cinematic aerial shot of a coastal city at golden hour";
const duration = 5;
const apiUrl = `https://api.useapi.net/v1/runwayml/videos/create`;
const token = "API token";
const data = {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json' }
};
data.body = JSON.stringify({
  model,
  text_prompt,
  duration
});
const response = await fetch(apiUrl, data);
const result = await response.json();
console.log("response", {response, result});

import requests
model = "gen4.5"
text_prompt = "A cinematic aerial shot of a coastal city at golden hour"
duration = 5
apiUrl = f"https://api.useapi.net/v1/runwayml/videos/create"
token = "API token"
headers = {
    "Content-Type": "application/json",
    "Authorization" : f"Bearer {token}"
}
body = {
    "model": f"{model}",
    "text_prompt": f"{text_prompt}",
    "duration": duration
}
response = requests.post(apiUrl, headers=headers, json=body)
print(response, response.json())