[中文]

用途

获取指定 YouTube 视频的音频或视频下载链接、格式信息和链接有效期。
本接口返回链接，不返回媒体文件，也不合并音视频。

请求方式

使用 POST + JSON，通过 Authorization: Bearer <API_TOKEN> 认证。

使用 HTTPS 调用；不要把代理密码放进 URL 查询参数。

参数

video_id：必填，11 位视频 ID，例如 phlZ2J3x4hI。

proxy_url：必填，http://用户名:密码@公网代理地址:端口。
支持 HTTP 代理，下载目标使用 HTTPS；不支持 SOCKS 或 HTTPS 代理协议。
用户名、密码中的 @、:、/ 等保留字符需要 URL 编码。
必须提供固定公网出口，或已配置粘性会话的完整代理地址。
代理不可指向内网、回环或链路本地地址。

itags：可选，1–4 个不重复的数字字符串，默认 ["137", "140"]。
常见格式：137 为 1080p MP4 纯视频，140 为 M4A 音频；
并非每个视频都有这些格式，任一所选格式不可用时请求失败，不自动替换格式。

verify_download：可选，默认 false。设为 true 时尝试读取各流前 1 KiB，
会增加耗时及少量代理流量，不保证整个文件可下载。

下载要求

下载程序必须使用与本次请求相同的代理会话和实际公网出口 IP，
并携带 streams[].download_headers。仅国家或 session 字符串相同不够。

不要在未配置该代理的浏览器中直接打开链接，换出口可能返回 403。

下载开始前可核对当前代理公网 IP 是否等于 proxy_exit_ip。

链接在 expires_at 指定的 Unix 秒时间戳到期；expires_in_seconds 是响应时剩余秒数。
代理会话可能更早失效，不能将链接有效期视为会话有效期。

视频流和音频流通常分离；需要完整音画文件时由下载端分别下载后合并。
使用者承担自带代理的费用和下载流量费用。

返回值与计费

streams：按所选格式返回 itag、url、媒体信息、请求头和有效期。

proxy_exit_ip：本次请求的代理公网出口；same_proxy_required 为 true。

proxy_exit_verified：本次请求的出口检查是否通过，不代表未来不会变更。

download_verification_requested：本次是否请求小字节验证。

streams[].verification：开启验证时包含 status、bytes_read、ok 和 duration_ms。
streams[].verified / all_selected_streams_verified 为布尔值；未验证时为 null。

HTTP 200 表示链接获取成功并按接口单价计费，包括小字节验证结果为 false 的响应。
请检查验证字段，HTTP 200 不等于完整文件下载成功。

HTTP 400 表示参数或链接获取失败，不计费。代理凭据不会在响应参数中回显，
本接口不提供公开的响应缓存链接。

请求示例

{
  "video_id": "phlZ2J3x4hI",
  "proxy_url": "http://USERNAME:PASSWORD@proxy.example.com:1000",
  "itags": ["137", "140"],
  "verify_download": false
}

[English]

Purpose and request

Get selected video/audio download URLs, format metadata and expiration times.
This endpoint does not return media files or merge audio and video.
Send a POST JSON body over HTTPS with Authorization: Bearer <API_TOKEN>.
Never put proxy credentials in URL query parameters.

Parameters

video_id: required, an 11-character YouTube video ID.

proxy_url: required, http://USERNAME:PASSWORD@PUBLIC_HOST:PORT.
Only HTTP proxies are supported; media destinations use HTTPS.
URL-encode reserved characters in credentials. Private, loopback and link-local
destinations are not allowed. Supply a fixed public exit or a fully configured sticky session.

itags: 1–4 unique numeric strings, default ["137", "140"].
Common formats: 137 is 1080p MP4 video-only; 140 is M4A audio-only.
Availability varies by video. The request fails if any selected format is missing;
formats are not silently substituted.

verify_download: default false. If enabled, probe up to 1 KiB per stream.
This adds latency and small proxy traffic, and does not verify an entire file.

Download requirements

Use the same proxy session and actual public exit IP, together with each stream's
download_headers. The same country or session name alone is insufficient.
A browser or downloader using a different exit may receive HTTP 403.
Before downloading, compare the proxy's current public IP with proxy_exit_ip.
expires_at is a Unix timestamp in seconds; expires_in_seconds is the remaining
URL lifetime at response time. The proxy session may expire sooner. Download separate
audio/video streams and merge them locally when necessary. You pay your own proxy
provider's connection and download traffic charges.

Response and billing

streams contains selected formats, URLs, headers and expiry values.
same_proxy_required is true. proxy_exit_verified describes checks for this request,
not a guarantee that the exit will remain unchanged.
download_verification_requested indicates whether small-byte verification was requested.
Each verification includes status, bytes_read, ok and duration_ms when enabled.
verified and all_selected_streams_verified are null when verification is disabled.
HTTP 200 means URL extraction succeeded and is charged, even if optional verification
reports false. It does not guarantee a successful full-file download.
HTTP 400 is not charged. Proxy credentials are not echoed, and no public response-cache
link is provided. The JSON example above applies to both language sections.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.tikhub.io/api/v1/youtube/web_v2/get_video_streams_v3' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "itags": [ "137", "140" ], "proxy_url": "http://USERNAME:PASSWORD@proxy.example.com:1000", "verify_download": false, "video_id": "phlZ2J3x4hI" }'

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

使用自带固定出口代理获取下载链接 / Get download URLs with your fixed-exit proxy

[中文]

用途

请求方式

参数

下载要求

返回值与计费

请求示例

[English]

Purpose and request

Parameters

Download requirements

Response and billing

Request

Responses

使用自带固定出口代理获取下载链接 / Get download URLs with your fixed-exit proxy

[中文]#

用途#

请求方式#

参数#

下载要求#

返回值与计费#

请求示例#

[English]#

Purpose and request#

Parameters#

Download requirements#

Response and billing#

Request

Responses

[中文]

用途

请求方式

参数

下载要求

返回值与计费

请求示例

[English]

Purpose and request

Parameters

Download requirements

Response and billing