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.4,
      "z": 0,
      "r": -6,
      "bg_x_pan": 0,
      "bg_y_pan": 0
    }
  }
}
'
{
  "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 兼容格式的 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

请求处理耗时。