获取视频流信息/Get video streams info

[中文]

⚠️ 重要说明:

• 此接口仅返回格式信息，URL 字段为 null
• 必须搭配 get_signed_stream_url 接口获取播放地址
• 如需一次性获取所有 URL，请使用 get_video_streams_v2 接口

用途:

• 获取YouTube视频所有清晰度的格式信息
• 返回标准格式（音视频合并）和自适应格式（音视频分离）

参数:

• video_id: 视频ID（推荐）
• video_url: 完整的视频URL（可选，如果提供video_id则忽略）

返回数据包含:

• 视频基本信息（标题、作者、时长、观看次数等）
• formats: 标准格式流（包含音频和视频）
• adaptive_formats: 自适应格式流（仅视频或仅音频）
  • 每个格式包含: itag、mime_type、质量标签、分辨率、比特率等
  • ⚠️ url 字段为 null（YouTube 需要签名解密才能获取真实播放地址）
  • has_signature 为 true 表示需要使用 get_signed_stream_url 接口
• hls_manifest_url: HLS流地址（如果有）
• dash_manifest_url: DASH流地址（如果有）
• available_qualities: 所有可用的清晰度列表

使用流程（两步法）:

1. 第一步: 调用此接口获取所有可用格式信息（URL 为 null）
2. 第二步: 从返回的 formats 或 adaptive_formats 中选择需要的 itag
3. 第三步: 调用 get_signed_stream_url 接口，传入 video_id 和 itag，获取真实播放地址

注意事项:

• YouTube 视频播放地址需要签名解密，原始 API 返回的 URL 字段为 null 是正常现象
• 播放地址必须通过 get_signed_stream_url 接口单独获取
• 高清视频（720p+）通常需要分别下载音视频流并合并

价格:

• $0.001 USD/请求

[English]

⚠️ Important Notice:

• This endpoint ONLY returns format information, URL fields are null
• MUST use get_signed_stream_url endpoint to get playback URLs
• For getting all URLs at once, use get_video_streams_v2 endpoint

Purpose:

• Get all quality format information for YouTube video
• Returns standard formats (merged audio/video) and adaptive formats (separate audio/video)

Parameters:

• video_id: Video ID (recommended)
• video_url: Full video URL (optional, ignored if video_id is provided)

Returns:

• Basic video info (title, author, duration, view count, etc.)
• formats: Standard format streams (audio and video combined)
• adaptive_formats: Adaptive format streams (video-only or audio-only)
  • Each format contains: itag, mime_type, quality label, resolution, bitrate, etc.
  • ⚠️ url field is null (YouTube requires signature decryption to get actual playback URL)
  • has_signature=true means need to use get_signed_stream_url endpoint
• hls_manifest_url: HLS manifest URL (if available)
• dash_manifest_url: DASH manifest URL (if available)
• available_qualities: List of all available quality levels

Usage Flow (Two-Step Method):

1. Step 1: Call this endpoint to get all available format information (URLs are null)
2. Step 2: Select the desired itag from returned formats or adaptive_formats
3. Step 3: Call get_signed_stream_url endpoint with video_id and itag to get actual playback URL

Notes:

• YouTube video playback URLs require signature decryption, null URL fields in raw API response is normal
• Playback URLs must be obtained separately via get_signed_stream_url endpoint
• High-quality videos (720p+) usually require separate download and merge of audio/video streams

Price:

• $0.001 USD/request

[示例/Example]

Step 1 - 获取格式信息: video_id = "dQw4w9WgXcQ"

Step 2 - 获取播放地址: use get_signed_stream_url with selected itag

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.