🎬 Video Model runwayML gen3a_turbo gen4_turbo

2025.08.21 This site now supports the official Runway video model gen4_aleph
2025.04.22 This site now supports the official Runway video model gen4_turbo
2024.11.16 This site now supports the official Runway video model gen3a_turbo
Supports image-to-video
Billing: per generation — duration options are 5s and 10s; 10s costs twice the price of 5s
How to use: visit https://runway.ddaiai.com and see the Online Test section below
Official documentation: https://docs.dev.runwayml.com/api/

Online Test 1. Visit https://runway.ddaiai.com (if blocked, try changing the subdomain prefix to suibian)

2. If you find it blocked, you can change the address yourself — replace suibian in https://suibian.ddaiai.com with something else, e.g. https://2025.ddaiai.com — all variants work

Online Test

Configuration

Open https://runway.ddaiai.com
Configure the settings as shown in the screenshot below
Runway API base URL: https://api.openai-hk.com
Runway KEY: hk-your-apiKey

Runway

Result

Result Runway

Runway API

The request header must include Authorization: Bearer hk-your-key
Runway API base URL: https://api.openai-hk.com/runwayml

Create a Video Task

post https://api.openai-hk.com/runwayml/v1/image_to_video

curl

shell

curl --request POST \
  --url https://api.openai-hk.com/runwayml/v1/image_to_video \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "promptImage": [
        {"uri":"https://www.openai-hk.com/res/img/open.png","position":"first"},
        {"uri":"https://www.openai-hk.com/res/img/open.png","position":"last"}
    ],
    "seed": 4294967295,
    "model": "gen4_turbo",
    "promptText": "wave",
    "watermark": false,
    "duration": 5,
    "ratio": "960:960"
  }'

curl --request POST \
  --url https://api.openai-hk.com/runwayml/v1/image_to_video \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "promptImage": [
        {"uri":"https://www.openai-hk.com/res/img/open.png","position":"first"},
        {"uri":"https://www.openai-hk.com/res/img/open.png","position":"last"}
    ],
    "seed": 4294967295,
    "model": "gen4_turbo",
    "promptText": "wave",
    "watermark": false,
    "duration": 5,
    "ratio": "960:960"
  }'

Request body

json

{
  "promptImage": [
    {
      "uri": "https://www.openai-hk.com/res/img/open.png",
      "position": "first"
    },
    { "uri": "https://www.openai-hk.com/res/img/open.png", "position": "last" }
  ],
  "seed": 4294967295,
  "model": "gen4_turbo",
  "promptText": "wave",
  "watermark": false,
  "duration": 5,
  "ratio": "1280:768"
}

{
  "promptImage": [
    {
      "uri": "https://www.openai-hk.com/res/img/open.png",
      "position": "first"
    },
    { "uri": "https://www.openai-hk.com/res/img/open.png", "position": "last" }
  ],
  "seed": 4294967295,
  "model": "gen4_turbo",
  "promptText": "wave",
  "watermark": false,
  "duration": 5,
  "ratio": "1280:768"
}

Key field descriptions

Field	Type	Description
promptImage	object[]	Reference images for the first and last frames
promptImage[0].uri	string	Can be an image URL or base64
promptImage[0].position	string	Frame position: `first` for the first frame, `last` for the last frame
duration	int	Duration: 5 or 10
seed	int	Seed
ratio	string	`gen3a_turbo` only supports `1280:768` (landscape) and `768:1280` (portrait); `gen4_turbo` supports `1280:720` `720:1280` `1104:832` `832:1104` `960:960` `1584:672`
model	string	Supported models: `gen3a_turbo` `gen4_turbo`
notify_hook	string	Callback URL — optional

Response body

json

{
  "id": "c7f2b640-9adb-4565-8e99-f759cacef00c"
}

{
  "id": "c7f2b640-9adb-4565-8e99-f759cacef00c"
}

The returned task.id is the TaskID used for task queries.

Task Query

get https://api.openai-hk.com/runwayml/v1/tasks/{TaskID}

shell

curl --request GET \
  --url https://api.openai-hk.com/runwayml/v1/tasks/c7f2b640-9adb-4565-8e99-f759cacef00c \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \

curl --request GET \
  --url https://api.openai-hk.com/runwayml/v1/tasks/c7f2b640-9adb-4565-8e99-f759cacef00c \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \

Response body — success

json

{
  "id": "c7f2b640-9adb-4565-8e99-f759cacef00c",
  "output": [
    "https://dnznrvs05pmza.cloudfront.net/94a66520-1a1b-43c3-a684-676b3f7dabae.mp4?_jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXlIYXNoIjoiMDdmYzk5YjQxNmFlZTdiYSIsImJ1Y2tldCI6InJ1bndheS10YXNrLWFydGlmYWN0cyIsInN0YWdlIjoicHJvZCIsImV4cCI6MTczMTgwMTYwMH0.BbJr86wkWwEjngHBwQutQV-4BgQjG1jdQsMLS4eAxN0"
  ],
  "status": "SUCCEEDED",
  "createdAt": "2024-11-15T13:54:50.800Z"
}

{
  "id": "c7f2b640-9adb-4565-8e99-f759cacef00c",
  "output": [
    "https://dnznrvs05pmza.cloudfront.net/94a66520-1a1b-43c3-a684-676b3f7dabae.mp4?_jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXlIYXNoIjoiMDdmYzk5YjQxNmFlZTdiYSIsImJ1Y2tldCI6InJ1bndheS10YXNrLWFydGlmYWN0cyIsInN0YWdlIjoicHJvZCIsImV4cCI6MTczMTgwMTYwMH0.BbJr86wkWwEjngHBwQutQV-4BgQjG1jdQsMLS4eAxN0"
  ],
  "status": "SUCCEEDED",
  "createdAt": "2024-11-15T13:54:50.800Z"
}

Response body — failure

json

{
  "id": "87f8a40c-2bf2-4a58-9fdc-486ed7c7244d",
  "status": "FAILED",
  "failure": "Text prompt did not pass moderation",
  "createdAt": "2024-11-15T16:06:41.521Z",
  "failureCode": "INPUT_PREPROCESSING.SAFETY.TEXT"
}

{
  "id": "87f8a40c-2bf2-4a58-9fdc-486ed7c7244d",
  "status": "FAILED",
  "failure": "Text prompt did not pass moderation",
  "createdAt": "2024-11-15T16:06:41.521Z",
  "failureCode": "INPUT_PREPROCESSING.SAFETY.TEXT"
}

video to video

Runway Gen4 Aleph is an advanced contextual video model that sets a new frontier for multi-task visual generation. It can perform extensive edits on input videos, such as adding, removing, and transforming objects, generating any angle of a scene, and modifying style and lighting, among other capabilities.
Price: 20,000 credits per generation

post https://api.openai-hk.com/runwayml/v1/video_to_video

shell

curl --request POST \
  --url https://api.openai-hk.com/runwayml/v1/video_to_video \
  --header 'Accept: */*' \
  --header 'Authorization: Bearer hk-your-hk-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "videoUri": "http://example.com",
    "promptText": "增加下雨效果",
    "seed": 4294967295,
    "model": "gen4_aleph",
    "references": [
      {
        "type": "image",
        "uri": "http://example.com"
      }
    ],
    "ratio": "1280:720",
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

curl --request POST \
  --url https://api.openai-hk.com/runwayml/v1/video_to_video \
  --header 'Accept: */*' \
  --header 'Authorization: Bearer hk-your-hk-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "videoUri": "http://example.com",
    "promptText": "增加下雨效果",
    "seed": 4294967295,
    "model": "gen4_aleph",
    "references": [
      {
        "type": "image",
        "uri": "http://example.com"
      }
    ],
    "ratio": "1280:720",
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

Request body

json

{
  "videoUri": "http://example.com",
  "promptText": "增加下雨效果",
  "seed": 4294967295,
  "model": "gen4_aleph",
  "references": [
    {
      "type": "image",
      "uri": "http://example.com"
    }
  ],
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}

{
  "videoUri": "http://example.com",
  "promptText": "增加下雨效果",
  "seed": 4294967295,
  "model": "gen4_aleph",
  "references": [
    {
      "type": "image",
      "uri": "http://example.com"
    }
  ],
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}

Key field descriptions

Field	Type	Description
videoUri	string	Reference video
promptText	string	Prompt text
references	object[]	Reference images
references[0].uri	string	Can be an image URL or base64
model	string	Supported model: `gen4_aleph`

Control a character

Runway Act Two uses a reference video to control a character's facial expressions and body movements.
Price: 10,000 credits per generation

post https://api.openai-hk.com/runwayml/v1/character_performance

shell

curl --request POST \
  --url https://api.openai-hk.com/runwayml/v1/character_performance \
  --header 'Accept: */*' \
  --header 'Authorization: Bearer hk-your-hk-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "character": {
      "type": "video",
      "uri": "http://example.com"
    },
    "reference": {
      "type": "video",
      "uri": "http://example.com"
    },
    "bodyControl": true,
    "expressionIntensity": 3,
    "seed": 4294967295,
    "model": "act_two",
    "ratio": "1280:720",
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

curl --request POST \
  --url https://api.openai-hk.com/runwayml/v1/character_performance \
  --header 'Accept: */*' \
  --header 'Authorization: Bearer hk-your-hk-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "character": {
      "type": "video",
      "uri": "http://example.com"
    },
    "reference": {
      "type": "video",
      "uri": "http://example.com"
    },
    "bodyControl": true,
    "expressionIntensity": 3,
    "seed": 4294967295,
    "model": "act_two",
    "ratio": "1280:720",
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

Request body

json

{
  "character": {
    "type": "video",
    "uri": "http://example.com"
  },
  "reference": {
    "type": "video",
    "uri": "http://example.com"
  },
  "bodyControl": true,
  "expressionIntensity": 3,
  "seed": 4294967295,
  "model": "act_two",
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}

{
  "character": {
    "type": "video",
    "uri": "http://example.com"
  },
  "reference": {
    "type": "video",
    "uri": "http://example.com"
  },
  "bodyControl": true,
  "expressionIntensity": 3,
  "seed": 4294967295,
  "model": "act_two",
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}

🎬 Video Model runwayML gen3a_turbo gen4_turbo ​

Online Test ​

Configuration ​

Result ​

Runway API ​

Create a Video Task ​

Task Query ​

video to video ​

Control a character ​

🎬 Video Model runwayML gen3a_turbo gen4_turbo

Online Test

Configuration

Result

Runway API

Create a Video Task

Task Query

video to video

Control a character