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": "https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4",
  "image": "https://db.xiaohuhd.com/1.jpeg",
  "callback_url": "https://example.com/webhook"
}
'
{
  "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 transfer expression or performance from a source video onto a separate image.

​
Current constraints

  • This route 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 task 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:https://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 returned by the task service.

​
data
object
required
​
message
string

Empty on success.

​
msg
string

Result message.