发起VR视频生成任务
接口说明:
客户通过此接口发起VR视频生成任务
此功能部署在客户内网环境中。域名需要客户自己提供。
请求路径:
{HostName}/api/v1/vr_video/task/
请求方式:
- POST
Headers:
{
"Content-Type": "application/json;charset=UTF-8"
}
入参示例
{
"zq_model_id": "众趣模型id",
"zq_house_id": "zq房源编号",
"callback_url": "http://callback/receive_video"
}
传入参数字段及含义:
| 字段名 | 类型 | 是否必传 | 含义 |
|---|---|---|---|
| zq_house_id | string | 否 | 房源在众趣平台的编号 |
| zq_model_id | string | 否 | 众趣模型id |
| callback_url | string | 否 | 任务完成后请求这个接口回调结果,这个接口的参数规则参考VR视频生成结果通知(回调) |
注意:zq_model_id和zq_house_id⼆者必须传其⼀,建议传模型id效率更⾼⼀些
响应参数示例
{
"msg": "success",
"code": 1,
"task_id": "c0501d66-eaf0-4777-ad85-5b2c464a50be"
}
响应参数字段及含义:
| 字段名 | 类型 | 是否必传 | 含义 |
|---|---|---|---|
| msg | string | 是 | 响应状态描述 |
| code | int | 是 | 响应状态码 |
| task_id | string | 是 | 任务id |
消息码code取值及说明:
| code值 | 说明 |
|---|---|
| 1 | 成功 |
| 2 | 缺少必要的参数 |
| 3 | ⽆此模型,请检查参数后重试 |
| 4 | 找到了多个对应模型:请检查参数后重试 |
| 5 | 接⼝出现未知的错误 |
| 6 | 模型已有正在进⾏的任务 |
| 9 | 发布任务到⽣产服务器出现未知异常 |
| -2 | 缺少必要的参数房源id或模型id请检查 |
| -4 | 没有绘制户型图,不⽀持⽣成VR视频 |
| 1002 | 失败,缺少校验参数 |
| 1003 | 失败,超时 |
| 1004 | 失败,签名校验失败 |