Skip to main content
POST
/
runway
/
pro
/
video2video
video2video 视频转视频 风格重绘
curl --request POST \
  --url https://api.deerapi.com/runway/pro/video2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "callback_url": "https://your-server.com/callback",
  "video": "http://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4",
  "model": "gen4",
  "prompt": "像素风格",
  "options": {
    "seconds": 5,
    "structure_transformation": 0.5,
    "flip": true
  }
}
'
{
  "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,
    "create_time": "<string>",
    "update_time": "<string>"
  },
  "exec_time": 123
}
通过此端点对已有视频进行风格转换和重绘。

调用前准备

  • 提供稳定可访问的源视频 video URL
  • 使用 model: gen4
  • 建议先用较低的 structure_transformation 值(如 0.3–0.5)测试效果,再逐步加强
  • callback_url 为必填项

任务流程

1

提交重绘任务

发送源视频、prompt 和 options 参数,保存返回的 task_id
2

轮询任务状态

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

保存输出视频

将最终视频转存到自有存储。输出链接为临时地址,应尽快保存。

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Headers

X-Runway-Version
string

Body

application/json
callback_url
string
default:example
required
video
string
default:example
required

输入的原始视频文件的URL地址。

model
string
default:gen4
required

指定用于处理视频的模型名称

prompt
string
default:Hello
required

用户提供的文本提示,用于指导视频处理或生成。

options
object
required

包含额外处理选项的对象。

Response

200 - application/json

OK

code
integer
required

HTTP状态码,200表示成功

msg
string
required

返回信息,描述请求结果

data
object
required

具体的响应数据

exec_time
number
required

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