Skip to main content
POST
/
runway
/
pro
/
act_one
Act-one Expression Migration
curl --request POST \
  --url https://api.cometapi.com/runway/pro/act_one \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video": "http://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4",
  "image": "https://db.xiaohuhd.com/1.jpeg",
  "callback_url": "http://baidu.com"
}
'
{
  "code": 123,
  "msg": "<string>",
  "data": {
    "task_id": "<string>"
  },
  "exec_time": 123
}
Use this endpoint to transfer expression or performance from a source video onto a separate image through the Runway reverse-format wrapper.

​
Current constraints

  • This route currently supports 16:9 source assets only
  • You need both a source video and a target image
  • Start with a short, stable source clip before you tune the workflow further

​
Task flow

1

Create the act-one task

Submit the source video, target image, and callback or tracking settings, then save the returned task id.
2

Poll the task

Continue with Feed Get Task until the wrapper reaches a terminal state.
3

Persist the result

Store the final output in your own media pipeline if you need durable access.

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
​
video
string
default:http://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4
required

URL of the source video containing the performance to transfer.

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

URL of the target image whose character will receive the expression.

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

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

Response

200 - application/json

OK

​
code
integer
required

HTTP status code

​
msg
string
required

Text description of the request result

​
data
object
required

Object containing specific response data.

​
exec_time
number
required

Time spent by the server processing this request