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": "http://baidu.com",
  "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": 123,
  "msg": "<string>",
  "data": {
    "task_id": "<string>"
  },
  "exec_time": 123
}
Use this endpoint to start a Runway reverse-format GEN-4 text-to-video task.

​
Required fields on CometAPI

  • callback_url is currently required by the wrapper
  • prompt, ratio, style, and model define the generation request
  • options.seconds and options.motion_vector are required by the current wrapper schema

​
Validated request path

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

​
Task flow

1

Create the task

Submit the request and store the returned task_id.
2

Poll the reverse-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.
If you omit callback_url, the current CometAPI wrapper returns callback_url_empty even though this is a task-based async API.

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 or business status code

​
msg
string
required

Text description of the status code

​
data
object
required

Business data body containing detailed task information

​
exec_time
number
required

Execution time of the API interface itself (in seconds), does not represent the total video generation time