获取 YouTube 已有字幕及时间标记

{
  "type": "object",
  "required": [],
  "properties": {
    "body": {
      "type": "object",
      "title": "YouTube Input: Video or Channel",
      "properties": {
        "end_date": {
          "type": "string",
          "title": "End Date",
          "editor": "textfield",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?([+-]\\d{2}:\\d{2}|Z)?)?$",
          "description": "可选，仅用于频道，获取在指定日期或之前上传的视频。支持 YYYY-MM-DD 日期或 ISO 8601 时间戳，结束日期不能早于 start_date；省略时服务使用当天日期。单视频模式忽略本项，具体时区边界没有明确说明。"
        },
        "language": {
          "type": "string",
          "title": "Transcript language (ISO 639-1)",
          "editor": "textfield",
          "pattern": "^[a-z]{2}$",
          "description": "可选，填写恰好两个小写字母的 ISO 639-1 代码，例如 en 或 fr，适用于视频和频道。使用默认选择时省略此字段，不要传空字符串。它请求已有字幕语言，所选语言不可用时可能回退到其他可用语言，并不翻译内容。"
        },
        "max_videos": {
          "type": "integer",
          "title": "Max Videos to Fetch",
          "editor": "number",
          "default": 10,
          "maximum": 200,
          "minimum": 1,
          "description": "可选整数，范围 1 至 200，默认 10，限制频道上传日期范围内要获取的视频数量。单视频模式忽略本项；不保证取得相同数量的成功字幕，也不保证完整频道历史。"
        },
        "start_date": {
          "type": "string",
          "title": "Start Date",
          "editor": "textfield",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?([+-]\\d{2}:\\d{2}|Z)?)?$",
          "description": "可选，仅用于频道，获取在指定日期或之后上传的视频。支持 YYYY-MM-DD 日期或 ISO 8601 时间戳，end_date 不能早于本开始日期；省略时服务从 30 天前开始。单视频模式忽略本项，具体时区边界没有明确说明。"
        },
        "channel_url": {
          "type": "string",
          "title": "YouTube Channel URL",
          "editor": "textfield",
          "pattern": "^(https?://)?(www\\.)?youtube\\.com/(channel/|c/|@)[a-zA-Z0-9_.-]+(\\?.*)?$",
          "prefill": "https://www.youtube.com/@taostats",
          "description": "可选，指定一个已选 YouTube 频道，使用支持的 /channel/、/c/ 或 /@ 地址形式。选择本项时不同时填写 youtube_url，可使用频道数量上限和上传日期筛选。预填频道只是示例，不是默认值。"
        },
        "youtube_url": {
          "type": "string",
          "title": "YouTube Video URL",
          "editor": "textfield",
          "pattern": "^(https?://)?(www\\.)?(youtube\\.com/(watch\\?v=|embed/|v/|shorts/)|youtu\\.be/)[a-zA-Z0-9_-]{11}(\\?.*)?$",
          "prefill": "https://www.youtube.com/watch?v=gN07gbipMoY",
          "description": "可选，指定一个已选 YouTube 视频，支持 watch、embed、v、Shorts 或 youtu.be 地址形式。选择本项时不同时填写 channel_url，并省略频道筛选设置。预填视频只是示例，不是默认值；可通过 language 请求已有字幕语言。"
        },
        "include_transcript_text": {
          "type": "boolean",
          "title": "Include Transcript (w/o timestamps)",
          "editor": "checkbox",
          "default": false,
          "description": "可选，默认 false。设为 true 且字幕可用时，除带时间标记的片段外，附加拼接后的连续字幕文本，不含时间标记。它不生成新字幕，也不保证交付字幕文件。"
        }
      },
      "description": "可选请求设置。查询时请在一个视频链接和一个频道链接之间二选一，明确提供所选输入，不同时带入两种预填示例。语言与连续文本设置适用于两种模式，上传日期和视频数量上限只用于频道。",
      "schemaVersion": 1,
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}