Skip to main content
POST
/
runway
/
pro
/
generate
generate(text)
curl --request POST \
  --url https://api.cometapi.com/runway/pro/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "callback_url": "https://example.com/webhook",
  "ratio": "16:9",
  "prompt": "a cat",
  "style": "cinematic",
  "model": "gen4",
  "options": {
    "seconds": 10,
    "motion_vector": {
      "x": 0,
      "y": 0.3999999999999999,
      "z": 0,
      "r": -6,
      "bg_x_pan": 0,
      "bg_y_pan": 0
    }
  }
}
'
{
  "code": 200,
  "message": "",
  "msg": "success",
  "data": {
    "task_id": "196642a0-05e1-441a-981e-eb0c1f5d983b"
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to start a Runway compatibility-format GEN-4 text-to-video task.

​
Required fields

  • callback_url is required
  • prompt, ratio, style, and model define the generation request
  • options.seconds and options.motion_vector are required

​
Validated request path

  • Header: X-Runway-Version: 2024-11-06
  • Model: gen4_turbo
  • Response: code: 200, msg: success, and data.task_id

​
Task flow

1

Create the task

Submit the request and store the returned task_id.
2

Poll the compatibility-format feed route

Continue with Feed Get Task to follow the task state.
3

Persist the finished asset

Once a video URL is available, move it into your own storage pipeline.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Headers

​
X-Runway-Version
string

Optional Runway API version header, for example 2024-11-06.

Body

application/json
​
callback_url
string
default:https://example.com/webhook
required

Webhook URL that receives a POST request with the result when the task completes.

​
ratio
string
default:16:9
required

Aspect ratio of the generated video, e.g. 16:9, 9:16, 1:1.

​
prompt
string
default:A cat sitting on a windowsill.
required

Text prompt describing the video content to generate.

​
style
string
default:cinematic
required

Artistic style for the generated video, e.g. cinematic.

​
model
string
default:gen4
required

Model version to use, e.g. gen4.

​
options
object
required

Advanced generation options including duration and camera motion.

Response

200 - application/json

OK

​
code
integer
required

HTTP status code returned by the task service.

​
data
object
required
​
message
string

Empty on success.

​
msg
string

Result message.