Skip to main content
POST
/
runway
/
pro
/
act_one
Act-one 表情迁移
curl --request POST \
  --url https://api.deerapi.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": "https://your-server.com/callback"
}
'
{
  "code": 123,
  "msg": "<string>",
  "data": {
    "task_id": "<string>",
    "state": "<string>",
    "status": "<string>",
    "prompt": "<string>",
    "prompt_en": null,
    "video_url": null,
    "poster": null,
    "last_frame": null,
    "msg": null,
    "point": "<string>",
    "refund": "<string>",
    "create_time": "<string>",
    "update_time": "<string>"
  },
  "exec_time": 123
}
通过此端点将源视频中的表情或表演动作迁移到目标图片上。

使用限制

  • 仅支持 16:9 比例的源素材
  • 需要同时提供源 video 和目标 image
  • 建议先用短而稳定的源视频片段测试

任务流程

1

创建 Act-One 任务

提交源视频、目标图片和 callback_url,保存返回的 task_id
2

轮询任务状态

使用获取任务状态端点查询,直到任务进入终态。
3

保存生成结果

将最终视频转存到自有存储,链接为临时地址。

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Headers

X-Runway-Version
string

Body

application/json
video
string
default:example
required

作为输入的视频文件的URL地址。

image
string
default:example
required

作为输入的图片文件的URL地址

callback_url
string
default:example
required

Response

200 - application/json

OK

code
integer
required

HTTP状态码

msg
string
required

对请求结果的文字描述

data
object
required

包含具体响应数据的对象。

exec_time
number
required

服务器处理此请求所花费的时间