Skip to content
On this page

视频信息查询接口

1.接口功能

该功能允许用户通过指定的千面动捕服务接口查询上传视频的制作状态。用户需要提供相关参数,如域名、视频ID以及企业凭证。用户通过访问特定的API路径来获取视频制作状态的信息。查询成功后,用户可以通过检查返回的状态码和消息来验证操作结果,并获取视频制作的详细状态信息。

2.请求方法

Post

3.请求路径

https://www.qmai.vip/business/getStatus/{videoId}/{companyKey}

4.请求参数(查询字符串)

  • videoId:必填,上传视频的ID,可在视频上传的返回获取,也可登录账号从网站获取。
  • companyKey:必填,企业唯一标识。

5.响应信息

服务端将以 JSON 格式返回响应数据。成功的响应会包含状态码、消息和数据;错误的响应会包含状态码和错误信息。

  • message:响应信息。格式为: {'动捕类型': '半身'}。动捕类型包含全身和半身。

  • videoId:上传的视频ID

  • status:接口调用状态

      200:成功
      600:系统异常
      500:参数异常
    
  • videoStatus:视频制作状态(待制作、制作中、制作完成、制作失败)。

6.python示例代码

# encoding=utf-8
import json
import requests

# Configuration
domain_url = "https://www.qmai.vip"
video_id = "1753336914494078977"
key = "f351974e-9d4e-46f1-b221-d0bf7c6d25df"

# Ensure URL ends with "/"
if not domain_url.endswith("/"):
    domain_url += '/'

# API endpoint URL
url = f"{domain_url}business/getStatus/{video_id}/{key}"
print(url)

# Make API request
response = requests.post(url)

# Check response status
if response.status_code == 200:
    response_data = json.loads(response.text)
    print(response_data)
else:
    print("访问链接失败")