> ## 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.
# 快速入门
> 获取视频下载器凭据，连接您的存储，并下载您的第一个 YouTube 视频。
## 1. 获取凭据
在[仪表板](https://dashboard.decodo.com/)中打开 **Web Data API** > **Video downloader**，复制 **Basic 认证令牌**（Basic auth token），并用它替换以下示例中的 `TOKEN VALUE`。
视频下载器使用独立的凭据。如果使用 Web Data API 密钥，此处会返回 `401`。
## 2. 准备存储
您需要一个视频下载器可以写入的存储文件夹，以及该存储的访问密钥和密钥。将它们组合成 `upload_url`：
```text theme={null}
https://:@//
```
[存储设置](/docs/cn/video-downloader-storage-setup)逐步介绍了 Amazon S3 的设置方法，并列出了其他支持的提供商。
## 3. 排队下载
发送 `POST` 请求，在 `query` 中填写 YouTube 视频 ID。此示例以最低画质下载视频的前 10 秒，是检查设置的低成本方式。
```shellscript cURL theme={null}
# 将 'TOKEN VALUE' 替换为您的视频下载器 Basic 认证令牌
curl --request 'POST' \
--url 'https://scraper-api.decodo.com/v2/task' \
--header 'Accept: application/json' \
--header 'Authorization: Basic TOKEN VALUE' \
--header 'Content-Type: application/json' \
--data '
{
"target": "youtube_video",
"query": "PFRn5zKJTD8",
"quality": "worst",
"start_time": "00:00:00",
"end_time": "00:00:10",
"upload_url": "https://access_key:access_secret@s3.us-west-2.amazonaws.com/your-bucket/video-folder"
}
'
```
```javascript Node theme={null}
const download = async () => {
const response = await fetch("https://scraper-api.decodo.com/v2/task", {
method: "POST",
headers: {
"Accept": "application/json",
"Content-Type": "application/json",
"Authorization": "Basic TOKEN VALUE" // 替换为您的视频下载器 Basic 认证令牌
},
body: JSON.stringify({
target: "youtube_video",
query: "PFRn5zKJTD8",
quality: "worst",
start_time: "00:00:00",
end_time: "00:00:10",
upload_url: "https://access_key:access_secret@s3.us-west-2.amazonaws.com/your-bucket/video-folder"
})
});
console.log(await response.json());
};
download();
```
```python Python theme={null}
import requests
url = "https://scraper-api.decodo.com/v2/task"
payload = {
"target": "youtube_video",
"query": "PFRn5zKJTD8",
"quality": "worst",
"start_time": "00:00:00",
"end_time": "00:00:10",
"upload_url": "https://access_key:access_secret@s3.us-west-2.amazonaws.com/your-bucket/video-folder"
}
headers = {
"accept": "application/json",
"content-type": "application/json",
"authorization": "Basic TOKEN VALUE" # 替换为您的视频下载器 Basic 认证令牌
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
```
响应会确认任务已进入队列。请保存 `id`，下一步需要用到。
```json JSON theme={null}
{
"target": "youtube_video",
"query": "PFRn5zKJTD8",
"id": "7515723240602382337",
"status": "pending",
"created_at": "2026-10-13 10:40:55",
"media": "audio_video",
"quality": "worst"
}
```
## 4. 查看结果
使用任务 `id` 发送 `GET` 请求。`204` 表示下载仍在进行中，`200` 表示下载已完成。
```shellscript cURL theme={null}
curl --request 'GET' \
--url 'https://scraper-api.decodo.com/v2/task/{task_id}/results' \
--header 'Authorization: Basic TOKEN VALUE'
```
上传成功时，`content` 包含文件名，`status_code` 为 `200`：
```json JSON theme={null}
{
"results": [
{
"content": "PFRn5zKJTD8_7515723240602382337.mp4",
"status_code": 200,
"url": "https://www.youtube.com/watch?v=PFRn5zKJTD8",
"task_id": "7515723240602382337",
"created_at": "2026-10-13 10:40:55",
"updated_at": "2026-10-13 10:41:05"
}
]
}
```
文件现已保存在您的存储文件夹中。如果 `status_code` 是其他值，请参阅[错误代码](/docs/cn/video-downloader-status-results)。
***
需要帮助或只是想打个招呼？我们的支持团队全天候为您服务。 \
您也可以随时通过电子邮件 [support@decodo.com](mailto:support@decodo.com) 联系我们。
找不到您要找的内容？请求一篇文章！ \
有反馈意见？分享您对我们如何改进的想法。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.