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": 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.

通过此端点使用参考图片创建 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 状态码。

msg
string
required

请求结果说明。

data
object
required
exec_time
number
required

请求处理耗时。