Skip to main content
POST
/
runway
/
pro
/
generate
Create a reverse-format Runway generate task
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",
  "image": "https://db.xiaohuhd.com/1.jpeg",
  "model": "gen4",
  "prompt": "Smile, Eat Burger"
}
'
{
  "code": 123,
  "msg": "<string>",
  "data": {
    "task_id": "<string>"
  },
  "exec_time": 123
}
Use this endpoint when you want the Runway reverse-format generate route with one or more reference images.

​
Before you call it

  • Send the required X-Runway-Version header, for example 2024-11-06
  • Use model: gen4
  • Provide the source image and the prompt that describes motion or transformation
  • Keep the first request simple before layering style and motion-vector tuning

​
Task flow

1

Create the reverse-format task

Submit the prompt, image, ratio, and options, then save the returned task id.
2

Poll the task

Continue with Feed Get Task. If the first poll returns task_not_exist, wait a few seconds and retry.
3

Persist the result

When the task completes, store the final asset in your own media pipeline if you need long retention.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Headers

​
X-Runway-Version
string

Optional Runway 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:1280:720
required

Aspect ratio of the generated video, e.g. 1280:720.

​
prompt
string
default:A paper boat gently rocks on calm water.
required

Text prompt describing the desired video content or motion.

​
model
string
default:gen4
required

Model version to use, e.g. gen4.

​
image
string
default:https://db.xiaohuhd.com/1.jpeg
required

URL of the source image to animate.

​
style
string

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

​
options
object

Advanced generation options.

​
last_image
string

URL of the end-frame image. When provided, the video transitions toward this frame.

Response

200 - application/json

OK

​
code
integer
required

HTTP status code or business status code, 200 usually indicates success

​
msg
string
required

Text description of the status code

​
data
object
required

Specific response data content

​
exec_time
number
required

Time spent processing this request