> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 参数

> 视频下载器的所有请求参数：视频 ID、存储 URL、媒体类型、画质和片段时间，以及批量请求。

| 参数 | 类型 | 必需 | 描述 | 默认值 | 示例 |
| - | - | - | - | - | - |
| `target` | string | ✅ | 固定为 `youtube_video`。 | | `youtube_video` |
| `query` | string | ✅ | YouTube 视频 ID。批量请求中为 ID 数组。 | | `dFu9aKJoqGg` |
| `upload_url` | string | ✅ | S3 兼容存储中某个文件夹的 URL，包含您的访问密钥和密钥。请参阅[存储设置](/docs/cn/video-downloader-storage-setup)。 | | `https://<key>:<secret>@<storage-host>/<bucket>/<folder>` |
| `media` | string | | `video`（无声音）、`audio`，或同时包含两者的 `audio_video`。 | `audio_video` | `audio` |
| `quality` | string | | 视频画质：`best`、`worst`、`480`、`720`、`1080`、`1440` 或 `2160`。 | `720` | `1080` |
| `start_time` | string | | 片段开始时间，格式为 `hh:mm:ss`。需与 `end_time` 一起发送。 | | `00:01:30` |
| `end_time` | string | | 片段结束时间，格式为 `hh:mm:ss`。需与 `start_time` 一起发送。 | | `00:02:00` |

## 限制

* 支持最长 12 小时的视频。
* 单次下载最长可持续 10 小时。
* 仅支持异步请求，不提供实时选项。

## 批量请求

将 `query` 作为数组发送到批量端点，即可一次排队多个视频。每个批量请求最多可包含 100 个视频，所有视频使用相同的 `upload_url` 和设置。

<CodeGroup>
  ```shellscript cURL theme={null}
  # 将 'TOKEN VALUE' 替换为您的视频下载器 Basic 认证令牌
  curl --request 'POST' \
          --url 'https://scraper-api.decodo.com/v2/task/batch' \
          --header 'Accept: application/json' \
          --header 'Authorization: Basic TOKEN VALUE' \
          --header 'Content-Type: application/json' \
          --data '
      {
        "target": "youtube_video",
        "query": [
          "PFRn5zKJTD8",
          "dFu9aKJoqGg"
        ],
        "upload_url": "https://access_key:access_secret@s3.us-west-2.amazonaws.com/your-bucket/video-folder"
      }
  '
  ```
</CodeGroup>

每个视频都有自己的任务 ID。请按照[状态与结果](/docs/cn/video-downloader-status-results)中的说明分别查询。

***

<Columns cols={2}>
  <Card title="支持" href="https://direct.lc.chat/12092754" cta="让我们聊聊！">
    需要帮助或只是想打个招呼？我们的支持团队全天候为您服务。 \
    您也可以随时通过电子邮件 [support@decodo.com](mailto:support@decodo.com) 联系我们。
  </Card>

  <Card title="反馈" href="mailto:feedback@decodo.com" cta="分享反馈">
    找不到您要找的内容？请求一篇文章！ \
    有反馈意见？分享您对我们如何改进的想法。
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.