使用概述

简介

百度网盘的核心API现在完全兼容MCP协议。涵盖了用户信息、获取文件信息、文件上传、文件管理、文件搜索等功能。开发者只需简单配置即可快速接入百度云服务，实现文件上传、文件管理等能力，显著降低了开发者接入云服务的门槛，并大幅提高了其开发效率。

功能介绍

功能名称	功能描述	功能描述
file_list	基本文件信息 - 获取文件列表	获取用户云盘指定目录下的文件列表。
file_doc_list	基本文件信息 - 获取文档列表	获取用户指定目录下的文档列表。
file_image_list	基本文件信息 - 获取图片列表	获取用户指定目录下的图片列表。
file_video_list	基本文件信息 - 获取视频列表	获取用户指定目录下的视频列表。
file_meta	基本文件信息 - 获取文件详情	通过文件ID获取云存储文件的详细信息。
make_dir	文件管理 - 创建文件夹	创建文件夹。
file_copy	文件管理 - 复制	复制指定文件。
file_del	文件管理 - 删除	对指定文件执行删除操作。
file_move	文件管理 - 移动	移动指定文件。
file_rename	文件管理 - 重命名	重命名指定文件。
file_upload_stdio	文件上传 - 上传本地文件	将用户的本地文件上传到基于云驱动的云端文件存储。</br>由于需要读取本地文件，上传本地文件仅支持STDIO模式。
file_upload_by_url	文件上传 - 通过URL上传	通过文件链接上传文件到云存储。
file_upload_by_url	文件上传 - 通过文本上传	通过文本内容上传文件到云存储。
file_keyword_search	文件搜索 - 文件名检索	云存储文件名关键词搜索。获取用户指定目录下包含指定关键字的文件列表。
file_semantics_search	文件搜索 - 文件语义检索	网盘文件语义检索，支持自然语言描述下的复杂query搜索网盘中的文件。
file_sharelink_set	文件共享 - 创建共享链接	创建文件共享链接。
user_info	用户基本信息 - 获取授权用户信息	获取用户基本信息。
get_quota	用户基本信息 - 获取网络硬盘容量信息	获取用户网络硬盘空间的使用状态。

基本文件信息 - 获取文件列表

 * 说明：获取用户网盘中指定目录下的文件列表，不限定文件类型。
 * 输入：
   * dir：目录名称，以 / 开头的绝对路径，默认为 /。路径包含中文时需要 UrlEncode 编码 (斜杠 / 也需要编码)
   * page：列表页码，从 1 开始， 如果不指定页码，则为不分页模式，返回所有的结果。如果指定 page 参数，则按修改时间倒序排列，默认为1从第一页拉取，拉取更多则依次传2、3、4等
 * 输出：
   * list（array）：文件信息列表。包含以下信息：
     * fsid：网盘文件ID
     * path：文件全路径
     * md5：文件MD5值
     * category：文件类型，1：视频 ；2：音频 ；3：图片 ；4：文档； 5：APP； 6：其他； 7：bt种子
     * size：文件大小，单位字节
     * filename：文件名
     * content：文件分段内容，如文档内容、视频字幕、音频文稿，若未生产返回空
     * thumbnail：图片缩略图地址
     * abstract：文件内容摘要，若未生产返回空

基本文件信息 - 获取文档列表

 * 说明：获取用户指定目录下的文档列表。
 * 输入：
   * dir：目录名称，以 / 开头的绝对路径，默认为 /。路径包含中文时需要 UrlEncode 编码 (斜杠 / 也需要编码)
   * page：列表页码，从 1 开始， 如果不指定页码，则为不分页模式，返回所有的结果。如果指定 page 参数，则按修改时间倒序排列，默认为1从第一页拉取，拉取更多则依次传2、3、4等
 * 输出：
   * list（array）：文件信息列表。包含以下信息：
     * fsid：网盘文件ID
     * path：文件全路径
     * md5：文件MD5值
     * category：文件类型，1：视频 ；2：音频 ；3：图片 ；4：文档； 5：APP； 6：其他； 7：bt种子
     * size：文件大小，单位字节
     * filename：文件名
     * content：文件分段内容，如文档内容、视频字幕、音频文稿，若未生产返回空
     * thumbnail：图片缩略图地址
     * abstract：文件内容摘要，若未生产返回空

基本文件信息 - 获取图片列表

 * 说明：获取用户指定目录下的图片列表。
 * 输入：
   * dir：目录名称，以 / 开头的绝对路径，默认为 /。路径包含中文时需要 UrlEncode 编码 (斜杠 / 也需要编码)
   * page：列表页码，从 1 开始， 如果不指定页码，则为不分页模式，返回所有的结果。如果指定 page 参数，则按修改时间倒序排列，默认为1从第一页拉取，拉取更多则依次传2、3、4等
 * 输出：
   * list（array）：文件信息列表。包含以下信息：
     * fsid：网盘文件ID
     * path：文件全路径
     * md5：文件MD5值
     * category：文件类型，1：视频 ；2：音频 ；3：图片 ；4：文档； 5：APP； 6：其他； 7：bt种子
     * size：文件大小，单位字节
     * filename：文件名
     * content：文件分段内容，如文档内容、视频字幕、音频文稿，若未生产返回空
     * thumbnail：图片缩略图地址
     * abstract：文件内容摘要，若未生产返回空

基本文件信息 - 获取视频列表

 * 说明：获取用户指定目录下的视频列表。
 * 输入：
   * dir：目录名称，以 / 开头的绝对路径，默认为 /。路径包含中文时需要 UrlEncode 编码 (斜杠 / 也需要编码)
   * page：列表页码，从 1 开始， 如果不指定页码，则为不分页模式，返回所有的结果。如果指定 page 参数，则按修改时间倒序排列，默认为1从第一页拉取，拉取更多则依次传2、3、4等
 * 输出：
   * list（array）：文件信息列表。包含以下信息：
     * fsid：网盘文件ID
     * path：文件全路径
     * md5：文件MD5值
     * category：文件类型，1：视频 ；2：音频 ；3：图片 ；4：文档； 5：APP； 6：其他； 7：bt种子
     * size：文件大小，单位字节
     * filename：文件名
     * content：文件分段内容，如文档内容、视频字幕、音频文稿，若未生产返回空
     * thumbnail：图片缩略图地址
     * abstract：文件内容摘要，若未生产返回空

基本文件信息 - 获取文件详情

 * 说明：通过文件ID获取网盘文件的详细信息。
 * 输入：
   * fsids：文件ID列表，支持批量查询，最大数量10个。如[111, 222, 333]
 * 输出：
   * list（array）：文件信息列表。包含以下信息：
     * fsid：网盘文件ID
     * path：文件全路径
     * md5：文件MD5值
     * category：文件类型，1：视频 ；2：音频 ；3：图片 ；4：文档； 5：APP； 6：其他； 7：bt种子
     * size：文件大小，单位字节
     * filename：文件名
     * content：文件分段内容，如文档内容、视频字幕、音频文稿，若未生产返回空
     * thumbnail：图片缩略图地址
     * abstract：文件内容摘要，若未生产返回空

文件管理 - 创建文件夹

 * 说明：创建文件夹。
 * 输入：
   * rtype：重命名策略，默认为1。0-不重命名（返回冲突），1-path冲突则重命名，2-path冲突且block_list不同才重命名，4-冲突则覆盖。
   * path：创建文件夹的绝对路径，需要urlencode
 * 输出：
   * fsid：网盘文件ID
   * category：分类类型, 6 文件夹
   * path：上传后使用的文件绝对路径
   * ctime：文件创建时间
   * mtime：文件修改时间
   * isdir：是否目录，0 文件、1 目录

文件管理 - 复制

 * 说明：对指定的文件进行复制操作。
 * 输入：
   * async：是否同步：0同步，1自适应，2异步。默认为1
   * ondup：全局ondup,遇到重复文件的处理策略, fail(直接返回失败)、newcopy(重命名文件)、overwrite（覆盖文件）、skip（跳过），默认为newcopy
   * filelist（json array）：示例：[{"path":"/test/123456.docx","dest":"/test/abc","newname":"11223.docx"}]
     * path：原文件绝对路径
     * dest：目标目录
     * newname：目标文件名
 * 输出：
   * taskid：异步任务id, 当async=2时返回

文件管理 - 删除

 * 说明：对指定的文件进行删除操作。
 * 输入：
   * async：是否同步：0同步，1自适应，2异步。默认为1
   * ondup：全局ondup,遇到重复文件的处理策略, fail(直接返回失败)、newcopy(重命名文件)、overwrite（覆盖文件）、skip（跳过），默认为newcopy
   * filelist（json array）：要删除文件的绝对路径，字符串数组，示例：["/test/123456.docx"]
 * 输出：
   * taskid：异步任务id, 当async=2时返回

文件管理 - 移动

 * 说明：用于对指定的文件进行移动操作。
 * 输入：
   * async：0 同步，1 自适应，2 异步
   * ondup：全局ondup,遇到重复文件的处理策略, fail(默认，直接返回失败)、newcopy(重命名文件)、overwrite、skip
   * filelist（json array）：示例：[{"path":"/test/123456.docx","dest":"/test/abc","newname":"11223.docx"}]
     * path：原文件绝对路径
     * dest：目标目录
     * newname：目标文件名
 * 输出：
   * taskid：异步任务id, 当async=2时返回
   * info（array）：文件信息

文件管理 - 重命名

 * 说明：对指定的文件进行重命名操作。
 * 输入：
   * async：是否同步：0同步，1自适应，2异步。默认为1
   * ondup：全局ondup，遇到重复文件的处理策略, fail(直接返回失败)、newcopy(重命名文件)、overwrite（覆盖文件）、skip（跳过），默认为newcopy
   * filelist（json array）：json串数组，示例：[{"path":"/test/123456.docx","newname":"