Baidu Netdisk Open Platform

https://pan.baidu.com/union/doc/
Admin
Baidu Netdisk Open Platform provides APIs and SDKs for developers to integrate cloud storage, file...
Tokens:2,669
Snippets:15
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### GET https://pan.baidu.com/rest/2.0/xpan/file?method=streaming

Source: https://pan.baidu.com/union/doc/%E5%9F%BA%E7%A1%80%E7%BD%91%E7%9B%98%E6%9C%8D%E5%8A%A1/%E6%92%AD%E5%8D%95%E8%83%BD%E5%8A%9B/%E6%92%AD%E5%8D%95%E4%B8%8B%E9%9F%B3%E9%A2%91%E6%92%AD%E6%94%BE

获取播单下音频文件的实时播放流，返回 M3U8 播放列表或广告信息。

```APIDOC
## GET https://pan.baidu.com/rest/2.0/xpan/file?method=streaming

### Description
获取播单下音频文件的实时播放流。调用方先通过获取播单下文件列表取得音频 path，再请求此接口获取 M3U8 播放列表，并交给播放器播放。

### Method
GET

### Endpoint
https://pan.baidu.com/rest/2.0/xpan/file

### Parameters
#### Query Parameters
- **method** (string) - Required - 固定值 streaming。
- **access_token** (string) - Required - OAuth 2.0 Token。
- **path** (string) - Required - 待播放音频在网盘中的绝对路径，以 / 开头并带文件名后缀，需整体 URL 编码。
- **type** (string) - Required - 转码格式。音频可选 M3U8_MP3_128、M3U8_HLS_MP3_128。
- **adToken** (string) - Optional - 首次请求返回 errno=133 时，将响应中的 adToken URL 编码后带回重试。
- **nom3u8** (int) - Optional - 传 1 时返回 JSON 状态信息而不是 M3U8 文本。

### Response
#### Success Response (200)
- **M3U8 文本** (string) - 播放流生成成功时返回 Content-Type: application/x-mpegURL 的 M3U8 文本。

#### Error Response (200)
- **errno** (int) - 错误码，如 133 (需看广告), -6 (Token 无效), 31066 (文件不存在)。
- **request_id** (uint64) - 请求 ID。
- **adTime** (int) - 广告时长 (errno=133 时)。
- **adToken** (string) - 广告令牌 (errno=133 时)。
- **ltime** (int) - 需等待的时间 (errno=133 时)。
```

--------------------------------

### 获取音频流请求示例 (cURL)

Source: https://pan.baidu.com/union/doc/%E5%9F%BA%E7%A1%80%E7%BD%91%E7%9B%98%E6%9C%8D%E5%8A%A1/%E6%92%AD%E5%8D%95%E8%83%BD%E5%8A%9B/%E6%92%AD%E5%8D%95%E4%B8%8B%E9%9F%B3%E9%A2%91%E6%92%AD%E6%94%BE

使用 cURL 发送 GET 请求获取音频流，需指定 method 为 streaming 并提供 access_token 和 path。

```bash
curl --location --get 'https://pan.baidu.com/rest/2.0/xpan/file' \
--data-urlencode 'method=streaming' \
--data-urlencode 'access_token=<ACCESS_TOKEN>' \
--data-urlencode 'path=/apps/<APP_NAME>/<FILE_NAME>.mp3' \
--data-urlencode 'type=M3U8_MP3_128' \
-H 'User-Agent: xpanvideo;netdisk;client' \
-H 'Host: pan.baidu.com'
```

--------------------------------

### 获取音频流请求示例 (Java)

Source: https://pan.baidu.com/union/doc/%E5%9F%BA%E7%A1%80%E7%BD%91%E7%9B%98%E6%9C%8D%E5%8A%A1/%E6%92%AD%E5%8D%95%E8%83%BD%E5%8A%9B/%E6%92%AD%E5%8D%95%E4%B8%8B%E9%9F%B3%E9%A2%91%E6%92%AD%E6%94%BE

使用 Java HttpURLConnection 发送 GET 请求并读取返回的 M3U8 文本流。

```java
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URI;
import java.net.URL;


public class StreamingExample {
    public static void main(String[] args) throws Exception {
        String query = "method=streaming"
            + "&access_token=<ACCESS_TOKEN>"
            + "&path=%2Fapps%2F<APP_NAME>%2F<FILE_NAME>.mp3"
            + "&type=M3U8_MP3_128";
        URL url = URI.create("https://pan.baidu.com/rest/2.0/xpan/file?" + query).toURL();
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        connection.setRequestMethod("GET");
        connection.setRequestProperty("User-Agent", "xpanvideo;netdisk;client");
        connection.setRequestProperty("Host", "pan.baidu.com");
        try (BufferedReader reader = new BufferedReader(
                new InputStreamReader(connection.getInputStream()))) {
            String line;
            while ((line = reader.readLine()) != null) {
                System.out.println(line);
            }
        }
    }
}
```

--------------------------------

### 获取音频流请求示例 (Python)

Source: https://pan.baidu.com/union/doc/%E5%9F%BA%E7%A1%80%E7%BD%91%E7%9B%98%E6%9C%8D%E5%8A%A1/%E6%92%AD%E5%8D%95%E8%83%BD%E5%8A%9B/%E6%92%AD%E5%8D%95%E4%B8%8B%E9%9F%B3%E9%A2%91%E6%92%AD%E6%94%BE

使用 Python requests 库获取 M3U8 播放列表，并根据 Content-Type 判断响应内容。

```python
import requests


response = requests.get(
    "https://pan.baidu.com/rest/2.0/xpan/file",
    params={
        "method": "streaming",
        "access_token": "<ACCESS_TOKEN>",
        "path": "/apps/<APP_NAME>/<FILE_NAME>.mp3",
        "type": "M3U8_MP3_128",
    },
    headers={"User-Agent": "xpanvideo;netdisk;client", "Host": "pan.baidu.com"},
    timeout=30,
)
if response.headers.get("Content-Type", "").startswith("application/x-mpegURL"):
    m3u8 = response.text
else:
    print(response.json())
```

--------------------------------

### 广告拦截响应示例

Source: https://pan.baidu.com/union/doc/%E5%9F%BA%E7%A1%80%E7%BD%91%E7%9B%98%E6%9C%8D%E5%8A%A1/%E6%92%AD%E5%8D%95%E8%83%BD%E5%8A%9B/%E6%92%AD%E5%8D%95%E4%B8%8B%E9%9F%B3%E9%A2%91%E6%92%AD%E6%94%BE

当接口返回 errno=133 时，表示需要观看广告，响应中包含 adToken 用于重试。

```json
{
  "errno": 133,
  "request_id": 1234567890,
  "adTime": 15,
  "adToken": "<ENCODED_AD_TOKEN>",
  "ltime": 15
}
```

--------------------------------

### M3U8 播放列表响应示例

Source: https://pan.baidu.com/union/doc/%E5%9F%BA%E7%A1%80%E7%BD%91%E7%9B%98%E6%9C%8D%E5%8A%A1/%E6%92%AD%E5%8D%95%E8%83%BD%E5%8A%9B/%E6%92%AD%E5%8D%95%E4%B8%8B%E9%9F%B3%E9%A2%91%E6%92%AD%E6%94%BE

成功获取音频流时返回的 M3U8 文本格式，包含分片信息和结束标识。

```text
#EXTM3U
#EXT-X-TARGETDURATION:15
#EXT-X-DISCONTINUITY
#EXTINF:2,
<SEGMENT_URL_1>
#EXTINF:2,
<SEGMENT_URL_2>
#EXTINF:2,
<SEGMENT_URL_3>
#EXTINF:4,
<SEGMENT_URL_4>
#EXTINF:10,
<SEGMENT_URL_5>
#EXT-X-ENDLIST
```
Tokens:
Raw