接入前必读

夺目开放了云端制作视频的功能,提供给第三方开发者。

开发者可以根据文档说明,正确请求接口,套用系统模板,快速生成视频。

成为开发者

首先需要发送邮件申请,简要介绍开发者信息以及应用场景。

申请通过后,我们会提供 api_keyapi_secret,并开通相关调用权限,此时申请人正式成为开发者。

申请开通邮箱:api@bestminr.com

获取 Access Token

请求接口时,需要提前使用 api_keyapi_secret 获取 access_token

每次请求接口时,在URL中带上 access_token 来获得使用权限。

获取 Access Token

配置回调地址

视频渲染任务完成需要几十秒到几分钟,因此系统提供了推送渲染任务进度的服务。

开发者需要提供一个服务器URL作为回调地址,目前需要工作人员手动配置到系统中。

每次调用提交渲染任务以后,视频状态改变或进度更新时,开发者填写的回调地址将收到服务器以 Http Request POST 方法推送的数据,开发者可以依据自身业务逻辑进行响应。

服务器配置正确,回调地址有效,才能收到渲染任务进度信息。

回调数据字段说明:

{
  "event": "video_update",   // 回调请求更新类型
  "data": {
    "status": "rendering",   // 渲染任务状态
    "messages": [],          // 返回信息
    "progression": "33.33",  // 渲染任务状态
    "video_id": "videoXXXX", // 视频 id
    "video_url": "",         // 渲染完成会有播放 url
  }
}

更新视频信息时,event的值为video_update

status渲染任务状态说明