Submit video generation task

POST

https://api.key4u.vn/runwayml/v1/image_to_video

Generate a video using the picture as the starting frame. After submission, the task id is returned and polled through GET /runwayml/v1/tasks/{task_id}.

Official documentation: https://docs.dev.runwayml.com/api/#tag/Start-generating/paths/~1v1~1image_to_video/post

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠400Bad request or validation failed

🟠401Missing or invalid API Key

Request Example

Shell

JavaScript

Java

Swift

cURL

gen4_turbogen4_turbo_2

curl --location 'https://api.key4u.vn/runwayml/v1/image_to_video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "duration": 5,
  "model": "gen4_turbo",
  "promptImage": "https://example.com/start-frame.jpg",
  "promptText": "The camera slowly zooms in",
  "ratio": "1280:720"
}'

Response Example

200 - example

{
  "batch_id": "",
  "created_at": "2024-12-22T13:38:40.139Z",
  "id": "4665a07c-7641-4809-a133-10786201bb56",
  "prompt": "",
  "state": "pending"
}

Modified at 2026-10-13 12:32:40

Query tasks (free)

Query video tasks (free)