AI 视频生成回调
当您向 Runway API 提交视频生成任务时，可以通过 callBackUrl参数设置回调地址。任务完成后，系统会自动将结果推送到您指定的地址。
回调机制概述
回调时机
回调方式
回调请求格式
callBackUrl 发送 POST 请求，格式如下：成功回调
失败回调
{
"code": 200,
"msg": "All generated successfully.",
"data": {
"task_id": "ee603959-debb-48d1-98c4-a6d1c717eba6",
"video_id": "485da89c-7fca-4340-8c04-101025b2ae71",
"video_url": "https://file.com/k/xxxxxxx.mp4",
"image_url": "https://file.com/m/xxxxxxxx.png"
}
}状态码说明
参数说明
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
code | integer | 是 | 回调状态码，表示任务处理结果 |
msg | string | 是 | 状态消息，提供详细的状态描述 |
data.task_id | string | 是 | 任务 ID，与您提交任务时返回的 taskId 一致 |
data.video_id | string | 是 | 生成的视频 ID，用于标识和追踪 |
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.
重要提醒