AI 视频扩展回调
您向 Runway API 提交视频扩展任务时，可以通过 callBackUrl参数设置回调地址。任务完成后，系统会自动将结果推送到您指定的地址。
回调机制概述
回调时机
回调方式
回调请求格式
callBackUrl 发送 POST 请求，格式如下：成功回调
失败回调
{
"code": 200,
"msg": "All generated successfully.",
"data": {
"image_url": "https://file.com/m/xxxxxxxx.png",
"task_id": "ee603959-debb-48d1-98c4-a6d1c717eba6",
"video_id": "485da89c-7fca-4340-8c04-101025b2ae71",
"video_url": "https://file.com/k/xxxxxxx.mp4"
}
}状态码说明
参数说明
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
code | integer | 是 | 回调状态码，表示任务处理结果 |
msg | string | 是 | 状态消息，提供详细的状态描述 |
data.task_id | string | 是 | 任务 ID，与您提交任务时返回的 taskId 一致 |
data.video_id | string | 否 | 视频唯一标识（仅成功时返回） |
data.video_url | string | 否 | 可访问的视频 URL，有效期 14 天（仅成功时返回） |
data.image_url | string | 否 | 生成视频的封面图片 URL（仅成功时返回） |
状态码详情
| 状态码 | 说明 |
|---|---|
| 200 | 成功 - 请求已成功处理 |
| 400 | 客户端错误 - 请求参数有误或内容不当 |
| 500 | 服务器错误 - 处理请求时发生意外错误 |
常见错误消息
回调接收示例
Node.js
Python
PHP
最佳实践
回调 URL 配置建议
1.
2.
3.
4.
5.
6.
7.
重要提醒
故障排查
扩展特定注意事项
AI 视频扩展特性
1.
2.
3.
4.
5.
6.