generate(文本) - DeerAPI-API文档

这里是一个简单的GEN-4文生视频传值示例

curl --location --request POST 'https://api.deerapi.com/runway/pro/generate' \ --header 'Authorization: Bearer {{api-key}}' \ --header 'X-Runway-Version: 2024-11-06' \ --header 'Content-Type: application/json' \ --data-raw '{ "callback_url": "http://baidu.com", "ratio": "16:9", "prompt": "一只小猫", "style": "cinematic", "model": "gen4", "options": { "seconds": 10, "motion_vector": { "x": 0, "y": 0.3999999999999999, "z": 0, "r": -6, "bg_x_pan": 0, "bg_y_pan": 0 } } }'

{ "code": 200, "msg": "成功", "data": { "task_id": "9f6243e5-3ab8-49c3-9c3c-6309ef5c96bd", "state": "", "status": "", "prompt": "", "prompt_en": null, "video_url": null, "poster": null, "last_frame": null, "msg": null, "point": "", "refund": "", "create_time": "", "update_time": "" }, "exec_time": 20.930577 }

请求参数

Header 参数

Authorization

string

可选

示例值:

Bearer {{api-key}}

X-Runway-Version

string

可选

示例值:

2024-11-06

Body 参数application/json

callback_url

string

必需

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

ratio

string

生成视频的宽高比

必需

prompt

string

必需

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

style

string

生成视频的艺术风格

必需

model

string

必需

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

options

object

其他高级配置选项

必需

seconds

integer

必需

期望生成的视频时长（单位：秒）

motion_vector

object

运镜或运动控制参数

必需

示例

返回响应

🟢200OK

application/json

成功

Body

code

integer

必需

HTTP状态码或业务状态码

msg

string

对状态码的文字描述

必需

data

object

必需

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

task_id

string

必需

创建的任务的唯一标识符

state

string

必需

任务的更详细状态或子状态

status

string

任务的当前主状态

必需

prompt

string

必需

提交时使用的原始prompt

prompt_en

null

必需

如果模型需要英文prompt，这里可能是翻译后的英文提示，null表示暂无或未使用

video_url

null

必需

生成的视频文件URL，任务成功后会填充此字段，null表示尚未生成或失败

poster

null

必需

视频的封面图URL，任务成功后可能填充，null表示暂无

last_frame

null

必需

视频最后一帧的图像URL，可能用于预览或特定用途，null表示暂无

msg

null

必需

关于任务的附加信息或错误提示，例如任务失败原因

point

string

必需

refund

string

必需

create_time

string

任务创建的时间戳

必需

update_time

string

必需

任务状态最后更新的时间戳

exec_time

number

必需

API接口本身的执行耗时（单位：秒），不代表视频生成总时长