Image-to-Video

POST /runway/pro/generate creates Runway GEN-4 video from reference images, with raw graphic transfer support and X-Runway-Version control.

POST /runway/pro/generate

Create a reverse-format Runway generate task

cURL

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"
}
'

200

{
  "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.

Show child attributes

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

Show child attributes

exec_time · number · required

Time spent processing this request