其他接口

从视频分享链接生成渲染数据

查询在夺目网站上的渲染任务数据,结果可以作为 API 提交渲染任务接口的请求的参数。

POST https://api.bestminr.com/api/duomu/user-theme-samples

这个接口可以方便开发者拼接渲染参数,推荐使用方法:

  1. 在夺目官网注册账号;
  2. 选择模板使用可视化编辑器编辑视频,提交渲染制作样片,导出分享链接;
  3. 通过视频分享链接地址,从本接口生成完整的渲染数据,通过这个接口进行重复查询;
  4. 调用 API的 提交渲染任务接口,把之前获得的数据作为参数,调用时要替换渲染参数中的素材url。

请求参数

Query Parameters

参数名 类型 是否必填 说明
access_token String 请求接口所需凭证

Request Headers

"Content-Type": "application/json"

Request Body

使用夺目分享链接查询,需要在 Request Body 中传入 url

{
  "url": "https://duomu.tv/show/video/<XXX>" // 夺目制作导出视频以后的分享链接
}

返回数据

返回数据data字段解释见渲染参数说明

{
  "theme_sample_id": "zu", // 样片id
  "status": "finished",    // 生成状态:finished,processing
  /* 生成的渲染数据,完成以后会有数据 */
  "data": {
    "theme_id": "Pib",
    "audio": {
        "url": "https://cdn.static.bestminr.com/production/theme_sample_resource/EVm.mp3"
    },
    "sections": [
      {
        "scene_name": "23_1",
        "duration": 69,
        "texts": {
          "title": {
            "content": "好的 茶叶",
            "x": 0.49689,
            "y": 0.833705,
            "text_align": "center",
            "font_size": 100,
            "text_shadow": "0.03em 0.03em 0.3em rgba(51, 51, 51, 0.6)"
          }
        },
        "footages": [
          {
            "url": "https://cdn.static.bestminr.com/production/theme_sample_resource/yIKT.mp4"
          }
        ]
      },
      ...
    ]
  }
}

注意事项

生成渲染数据的过程中,会将在夺目网站上制作时使用的素材,同步到可以被 API 访问的位置,方便辨别配置信息和调试。

系统会不定期删除同步的素材降低存储压力,因此开发者在得到渲染数据以后,需要自行替换相应位置素材的 url。

查询已经生成的渲染数据

根据样片id(theme_sample_id),查询已经生成的渲染数据。

GET https://api.bestminr.com/api/duomu/user-theme-samples/<theme_sample_id>

获取theme_sample_id需要先调用从视频分享链接生成渲染数据接口

请求参数

参数名 类型 是否必填 说明
access_token String 请求接口所需凭证

返回数据

{
  "theme_sample_id": "zu", // 样片id
  "status": "finished",    // 生成状态:finished,processing
  /* 生成的渲染数据,完成以后会有数据 */
  "data": {
    "theme_id": "Pib",
    "audio": {
      "url": "https://cdn.static.bestminr.com/production/theme_sample_resource/EVm.mp3"
    },
    "sections": [
      { /* 与上面接口相同 */ },
      ...
    ]
  }
}