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",
  "ratio": "16:9",
  "prompt": "一只小猫",
  "style": "cinematic",
  "model": "gen4_turbo",
  "options": {
    "seconds": 10,
    "motion_vector": {
      "x": 0,
      "y": 0.3999999999999999,
      "z": 0,
      "r": -6,
      "bg_x_pan": 0,
      "bg_y_pan": 0
    }
  }
}
'
{
  "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 兼容格式的 GEN-4 文本生成视频任务。

必填字段

  • callback_url — 任务完成后通过 POST 回调结果
  • promptratiostylemodel — 定义生成请求
  • options.seconds — 视频时长(秒)
  • options.motion_vector — 可选,控制运镜参数

任务流程

1

创建任务

提交请求,保存返回的 task_id
2

轮询任务状态

使用获取任务状态端点查询任务进度。
3

保存生成结果

视频 URL 返回后,将视频文件转存到自有存储。视频链接为临时地址,应尽快保存。

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

任务完成后,结果会通过POST请求回调到此URL

ratio
string
default:example
required

生成视频的宽高比

prompt
string
default:Hello
required

用于生成视频内容的文本描述或提示词

style
string
default:example
required

生成视频的艺术风格

model
string
default:gen4_turbo
required

使用的视频生成模型版本或名称

options
object
required

其他高级配置选项

Response

200 - application/json

OK

code
integer
required

HTTP状态码或业务状态码

msg
string
required

对状态码的文字描述

data
object
required

包含任务详细信息的业务数据主体

exec_time
number
required

API接口本身的执行耗时(单位:秒),不代表视频生成总时长