跳轉到主要內容
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
}
使用此端點可透過 Runway reverse-format wrapper,將來源影片中的表情或表演轉移到另一張獨立圖片上。

目前限制

  • 此路由目前僅支援 16:9 的來源素材
  • 你需要同時提供來源 video 與目標 image
  • 在進一步調整工作流程前,請先從一段短且穩定的來源片段開始

任務流程

1

建立 act-one 任務

提交來源影片、目標圖片,以及 callback 或追蹤設定,然後保存回傳的 task id。
2

輪詢任務

持續使用 Feed Get Task,直到 wrapper 進入終止狀態。
3

保存結果

如果你需要可持續存取,請將最終輸出儲存到你自己的媒體處理流程中。

授權

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

標頭

X-Runway-Version
string

Optional Runway version header, for example 2024-11-06.

主體

application/json
video
string
預設值:http://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4
必填

URL of the source video containing the performance to transfer.

image
string
預設值:https://db.xiaohuhd.com/1.jpeg
必填

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

callback_url
string
預設值:https://example.com/webhook
必填

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

回應

200 - application/json

OK

code
integer
必填

HTTP status code

msg
string
必填

Text description of the request result

data
object
必填

Object containing specific response data.

exec_time
number
必填

Time spent by the server processing this request