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": "https://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4",
  "image": "https://db.xiaohuhd.com/1.jpeg",
  "callback_url": "https://your-server.com/callback"
}
'
{
  "code": 200,
  "msg": "成功",
  "data": {
    "task_id": "221c136d-7888-43c3-acd3-1fcc90d51cfd",
    "state": "",
    "status": "0",
    "prompt": "",
    "prompt_en": null,
    "video_url": null,
    "raw_video_url": null,
    "poster": null,
    "last_frame": null,
    "msg": null,
    "create_time": "0",
    "update_time": "0"
  },
  "exec_time": 0
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.deerapi.com/llms.txt

Use this file to discover all available pages before exploring further.

通过此端点将源视频中的表情或表演动作迁移到目标图片上。

使用限制

  • 仅支持 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

请求处理耗时。