获取在线字幕列表，支持模糊搜索，按下载量排序返回

开发中

POST

/ugreen/v2/stream/transcode/subtitles/search

//语言编码
" "zh-CN": "CHS", // 中文（简体，中国） - Chinese Simplified
"en-US": "ENG", // 英文（美国） - English (United States)
"de-DE": "GER", // 德语（德国） - German
"ja-JP": "JPN", // 日语（日本） - Japanese
"es-ES": "SPA", // 西班牙语（西班牙） - Spanish
"nl-NL": "NLD", // 荷兰语（荷兰） - Dutch
"it-IT": "ITA", // 意大利语（意大利） - Italian
"fr-FR": "FRA", // 法语（法国） - French
"pt-PT": "PRT", // 葡萄牙语（葡萄牙） - Portuguese
"ko-KR": "KOR", // 韩语（韩国） - Korean

//结果会根据下载量排序
//返回50条，目前云端调用的API不支持分页

请求参数

Body 参数application/json

示例

{
    "query": "复仇者联盟",
    "language": "zh-CN",
    "video_path": "/tmp/video1.mp4",
    "season_number": 43,
    "episode_number": 95,
    "page": 1,
    "size": 50
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/ugreen/v2/stream/transcode/subtitles/search' \
--header 'Content-Type: application/json' \
--data '{
    "query": "复仇者联盟",
    "language": "zh-CN",
    "video_path": "/tmp/video1.mp4",
    "season_number": 43,
    "episode_number": 95,
    "page": 1,
    "size": 50
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功示例请求云端异常语言参数异常

{
  "code": 200,
  "msg": "success",
  "data": {
    "total_pages": 1,
    "total_count": 2,
    "size": 50,
    "page": 1,
    "data": [
      {
        "subtitle_id": 6659587,
        "language": "zh-CN",
        "download_count": 2834,
        "new_download_count": 1047,
        "upload_date": "2022-07-21 11:22:10",
        "season_number": 1,
        "episode_number": 1,
        "file_id": 7628853,
        "file_name": "绝命毒师.Breaking.Bad.Bluray",
        "status": 0,
        "file_path": "/tmp/subtitle1.ass"
      }
    ]
  }
}

修改于 2025-09-12 08:41:18

错误码汇总

字幕下载、状态查询