1. web端
个人项目
  • V2接口
    • 外部分享
    • 公共接口
      • ws保活
      • v2版本探测
      • 错误码汇总
    • 在线字幕
      • 获取在线字幕列表,支持模糊搜索,按下载量排序返回
      • 字幕下载、状态查询
      • 删除字幕文件
      • 获取视频目录下字幕文件列表
    • 音乐转码
      • 音乐转码创建
      • 音乐转码关闭
      • 音乐转码歌曲信息获取
      • 获取转码视频流
      • 获取转码播放配置文件M3U8
      • 心跳接口
      • 歌曲mediainfo信息获取
    • web端
      • 上传字幕-subtitle/upload
        POST
      • 关闭视频-close
        GET
      • 在线转码播放-play
        GET
      • 获取解析的字幕文件内容-subtitle
        GET
      • 获取转码视频摘要,创建转码器-info
        POST
      • 获取转码视频文件流m3u8
        GET
      • 获取转码视频流-get
        GET
      • 设置视频播放字幕-subtitle/:id
        POST
      • 设置视频播放音轨-audio/:id
        POST
    • app端
      • 批量获取iso播放文件时长-/iso/duration
      • iso格式视频文件播放路径获取-iso/path
      • 关闭视频-close
      • 原画播放获取视频流-raw/get
      • 在线转码播放-play
      • 获取字幕文件流-subtitle
      • 获取转码视频摘要,创建转码器-info
      • 获取转码视频文件流m3u8
      • 获取转码视频流-get
      • 转码视频段检查-status
      • 获取转码视频摘要,创建转码器-info Copy
  • 转码主流程接口-new
    • 开始播放
      POST
    • 获取视频元信息
      POST
    • 获取转码文件(.m3u8,.ts)
      GET
    • 转码状态变更接口(切分辨率,切字幕,切音轨,关闭退出)
      POST
  • V1接口
    • 获取视频目录下字幕文件列表
      POST
    • 错误码汇总
      GET
    • 上传字幕-subtitle/upload
      POST
    • 关闭视频-close
      GET
    • 关闭视频-close
      POST
    • 在线转码播放-play
      GET
    • 获取解析的字幕文件内容-subtitle
      GET
    • 获取转码视频摘要,创建转码器-info
      GET
    • 获取转码视频文件流m3u8
      GET
    • 获取转码视频流-get
      GET
    • 设置视频播放字幕-subtitle/:id
      POST
    • 设置视频播放音轨-audio/:id
      POST
    • 转码视频段检查-status
      GET
    • iso格式关闭播放-iso/close
      POST
    • iso格式视频文件播放-iso/path
      GET
    • 关闭视频-close
      POST
    • 原画播放获取视频流-raw/get
      GET
    • 在线转码播放-play
      GET
    • 获取字幕文件流-subtitle
      GET
    • 获取转码视频摘要,创建转码器-info
      GET
    • 获取转码视频文件流m3u8
      GET
    • 获取转码视频流-get
      GET
    • 转码视频段检查-status
      GET
    • 上传字幕-subtitle/upload
      POST
    • 关闭视频-close
      GET
    • 在线转码播放-play
      GET
    • 获取解析的字幕文件内容-subtitle
      GET
    • 获取转码视频摘要,创建转码器-info
      GET
    • 获取转码视频文件流m3u8
      GET
    • 获取转码视频流-get
      GET
    • 设置视频播放字幕-subtitle/:id
      POST
    • 设置视频播放音轨-audio/:id
      POST
    • 转码视频段检查-status
      GET
  • V1接口 Copy
    • 获取转码视频摘要,创建转码器-info
    • 获取转码视频文件流m3u8
    • 获取转码视频流-get
    • 设置视频播放字幕-subtitle/:id
    • 设置视频播放音轨-audio/:id
    • 转码视频段检查-status
    • iso格式关闭播放-iso/close
    • iso格式视频文件播放-iso/path
    • 关闭视频-close
    • 原画播放获取视频流-raw/get
    • 在线转码播放-play
    • 获取字幕文件流-subtitle
    • 获取转码视频摘要,创建转码器-info
    • 获取转码视频文件流m3u8
    • 获取转码视频流-get
    • 转码视频段检查-status
    • 上传字幕-subtitle/upload
    • 关闭视频-close
    • 在线转码播放-play
    • 获取解析的字幕文件内容-subtitle
    • 获取转码视频摘要,创建转码器-info
    • 获取转码视频文件流m3u8
    • 获取转码视频流-get
    • 设置视频播放字幕-subtitle/:id
    • 设置视频播放音轨-audio/:id
    • 转码视频段检查-status
    • 获取视频目录下字幕文件列表
    • 错误码汇总
    • 上传字幕-subtitle/upload
    • 关闭视频-close
    • 关闭视频-close
    • 在线转码播放-play
    • 获取解析的字幕文件内容-subtitle
  • 音乐安全测试
    • genre/modify
    • /v1/music/song/lyric
    • /v1/music/genre/modify
    • /v1/music/setting/del_invalid_file
    • /v1/music/get_file
    • /v1/music/share_lib/setting/add_dir
    • /ugreen/v1/user/edit
    • /v1/music/genre/del
    • by_folder
    • by_singer
    • foler/tree
    • foler/tree Copy
    • foler/tree Copy
  • FSC-TEST
    • 登录公钥获取
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
  1. web端

获取转码视频摘要,创建转码器-info

POST
/ugreen/v2/stream/transcode/web/info
获取视频转码信息,抢占转码器,若转码器不存在则创建新的转码器


新增字段dolby定义如下:
0 表示非杜比格式
1 表示杜比P5
2 表示杜比P7
3 表示杜比P8
4 未定义将来作为扩展使用
这里面主要判定是否为杜比P5,如果是P5则不能播放原画,需要转码播放来兼容。
也就是 dolby字段的值 是否等于 1

请求参数

Body 参数application/json

示例
{"video_path":"/mnt/@remote/webdav/webdav:uid=1000,host=172.17.90.83,port=5005,url=%2F%2F/07.字幕视频/内置pgs格式/4:3字幕偏瘦/E04.mkv","task_id":"1f3783e8ad53271b1f2f766e6aca70a5","timestamp":"1755826462359","token":"1E5622CCE563462CB64A58A862A8B373","src_type":2}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/ugreen/v2/stream/transcode/web/info' \
--header 'Content-Type: application/json' \
--data-raw '{"video_path":"/mnt/@remote/webdav/webdav:uid=1000,host=172.17.90.83,port=5005,url=%2F%2F/07.字幕视频/内置pgs格式/4:3字幕偏瘦/E04.mkv","task_id":"1f3783e8ad53271b1f2f766e6aca70a5","timestamp":"1755826462359","token":"1E5622CCE563462CB64A58A862A8B373","src_type":2}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "audios": [
            {
                "id": 4352,
                "language": "中文",
                "raw_language": "chi",
                "name": "dts",
                "title": "中文-dts-Mandarin [DTS5.1]",
                "isDefault": true
            },
            {
                "id": 4353,
                "language": "中文",
                "raw_language": "chi",
                "name": "eac3",
                "title": "中文-eac3-Mandarin [DDP5.1 Atmos]",
                "isDefault": false
            },
            {
                "id": 4354,
                "language": "中文",
                "raw_language": "chi",
                "name": "eac3",
                "title": "中文-eac3-Mandarin [DDP5.1]",
                "isDefault": false
            },
            {
                "id": 4355,
                "language": "中文",
                "raw_language": "chi",
                "name": "eac3",
                "title": "中文-eac3-Mandarin [DDP2.0]",
                "isDefault": false
            },
            {
                "id": 4356,
                "language": "中文",
                "raw_language": "chi",
                "name": "aac",
                "title": "中文-aac-Mandarin [AAC2.0]",
                "isDefault": false
            }
        ],
        "duration": 7784736,
        "framerate": 24,
        "hash": "7d2ead7a7df06088d88f935ca500cf10",
        "hdr10": true,
        "height": 1608,
        "is_hw_accel_support": true,
        "is_transcode": true,
        "support_lossless": false,
        "redir_link": "/ugreen/v1/stream/transcode/web/play?video_name=7d2ead7a7df06088d88f935ca500cf10.mkv\u0026token=E9BCBD83F1824C68A5B93F106B250A80",
        "resolution": {
            "cname": "超高清",
            "name": "4K"
        },
        "rotation": "",
        "segment": {
            "segment_duration": 3,
            "total_segment": 2595
        },
        "subtitles": null,
        "transcodeable": [
            {
                "cname": "超高清",
                "name": "4K",
                "resolution": "3840x1608"
            },
            {
                "cname": "超清",
                "name": "1080P",
                "resolution": "1920x800"
            },
            {
                "cname": "高清",
                "name": "720P",
                "resolution": "1280x536"
            },
            {
                "cname": "标清",
                "name": "480P",
                "resolution": "720x296"
            }
        ],
        "width": 3840
    },
    "time": 0.41073537
}
修改于 2025-09-12 08:41:18
上一页
获取解析的字幕文件内容-subtitle
下一页
获取转码视频文件流m3u8
Built with