获取缩略图 - Publish Helper API

请求参数

Query 参数

path

string

必需

视频路径（也可以是上级文件夹）

示例值:

D:/video/1.mp4

screenshotStoragePath

string

可选

图片储存路径（文件夹）（如果为空，则自动从后台读取）

示例值:

D:/pic

thumbnailRows

string

可选

缩略图横向数量（建议1-5）（如果为空，则自动从后台读取）

示例值:

3

thumbnailCols

string

可选

缩略图纵向数量（建议1-5）（如果为空，则自动从后台读取）

示例值:

3

screenshotStartPercentage

string

可选

截图开始位置的百分比（小数表示）（如果为空，则自动从后台读取）

示例值:

0.08

screenshotEndPercentage

string

可选

截图结束位置的百分比（小数表示）（如果为空，则自动从后台读取）

示例值:

0.92

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET '127.0.0.1:5372/api/getThumbnail?path=D:/video/1.mp4&screenshotStoragePath=D:/pic&thumbnailRows=3&thumbnailCols=3&screenshotStartPercentage=0.08&screenshotEndPercentage=0.92'

返回响应

🟢200成功

application/json

Body

data

object

数据

必需

包含返回数据

thumbnailPath

string

缩略图路径

必需

获得的缩略图路径

videoPath

string

视频文件路径

必需

获取缩略图的视频文件路径

message

string

提示信息

必需

用于返回提示信息

statusCode

enum<string>

状态码

必需

提示程序运行状态

枚举值:

OKFILE_PATH_ERRORVALUE_RANGE_ERRORVALUE_RELATIONSHIP_ERRORMISSING_REQUIRED_PARAMETERPARAMETER_RANGE_ERRORBACKEND_PROCESSING_ERRORUNAUTHORIZED_ACCESS_ERRORGENERAL_ERROR

示例

{
  "data": {
    "thumbnailPath": "D:/pic/20240327-215124-037528.png",
    "videoPath": "D:/video/1.mp4"
  },
  "message": "获取截图成功。",
  "statusCode": "OK"
}