Skip to main content
POST
/
runway
/
pro
/
generate
generate(参考图片)
curl --request POST \
  --url https://api.deerapi.com/runway/pro/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "callback_url": "https://your-server.com/callback",
  "image": "https://db.xiaohuhd.com/1.jpeg",
  "model": "gen4",
  "prompt": "笑起来,吃汉堡"
}
'
{
  "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
}
通过此端点使用参考图片创建 Runway 兼容格式的视频生成任务。

调用前准备

  • 使用 model: gen4
  • 提供源图片 image 和描述运动或变换的 prompt
  • 建议先用简单请求测试,再调整风格和运动矢量参数
  • options.seconds 为必填项

任务流程

1

创建任务

提交图片、prompt、ratio 等参数,保存返回的 task_id
2

轮询任务状态

使用获取任务状态端点查询。如果首次查询返回 task_not_exist,等待几秒后重试。
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

回调URL,用于接收处理结果的通知

ratio
string
default:example
required

生成视频的宽高比

prompt
string
default:Hello
required

图像处理或生成的提示语,描述期望的图像内容或变化

model
string
default:gen4
required

使用的模型版本,例如"gen4"

image
string
default:example
required

输入图片的URL地址

style
string

期望的图像风格,例如"cinematic"(电影感)

options
object

更多高级或特定的处理选项

last_image
string

尾帧

Response

200 - application/json

OK

code
integer
required

HTTP状态码或业务状态码,200 通常表示成功

msg
string
required

对状态码的文字描述

data
object
required

具体的响应数据内容

exec_time
number
required

处理该请求所花费的时间