bilibili-api-python视频上传模块中的source参数问题解析

bilibili-api-python视频上传模块中的source参数问题解析

【免费下载链接】bilibili-api 哔哩哔哩常用API调用。支持视频、番剧、用户、频道、音频等功能。原仓库地址：https://github.com/MoyuScript/bilibili-api 项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-api

在bilibili-api-python这个Python库中，视频上传功能(video_uploader)是许多开发者常用的核心功能之一。近期发现了一个关于转载视频上传时source参数缺失的问题，这个问题会导致上传失败并返回"稿件类型为转载时，转载来源不能为空"的错误。

问题背景

当使用bilibili-api-python库的video_uploader模块上传转载类型的视频时，系统要求必须提供视频的转载来源(source)信息。然而在当前版本(16.2.0)的实现中，即使开发者设置了copyright参数为2(表示转载)，系统也没有正确地将source参数包含在最终的提交数据中。

技术细节分析

从错误日志中可以清楚地看到，当copyright设置为2(转载)时，提交的数据结构中缺少了关键的source字段。B站API会严格检查这一点，如果发现是转载视频但没有提供来源，就会返回21021错误代码。

在视频上传流程中，_submit方法负责组装最终的提交数据。正确的实现应该检查copyright参数的值，如果是转载类型，则需要确保source参数存在且不为空。

解决方案

该问题的修复相对简单，主要需要：

1. 在组装提交数据时增加对copyright参数的检查
2. 如果是转载类型(copyright=2)，确保source参数被包含在提交数据中
3. 可以考虑添加参数验证，在初始化时就检查转载类型是否提供了source

最佳实践建议

对于使用bilibili-api-python进行视频上传的开发者，建议：

1. 明确视频的版权类型：原创(1)还是转载(2)
2. 如果是转载视频，务必设置source参数
3. 更新到修复此问题后的版本
4. 在上传前进行参数验证，避免因缺少必要参数导致上传失败

总结

这个问题的出现提醒我们，在使用第三方API时，必须仔细阅读文档并理解每个参数的含义和必要性。特别是像版权类型这样的关键参数，往往会有额外的关联参数要求。bilibili-api-python库的维护者已经快速响应并修复了这个问题，体现了开源社区的高效协作精神。

【免费下载链接】bilibili-api 哔哩哔哩常用API调用。支持视频、番剧、用户、频道、音频等功能。原仓库地址：https://github.com/MoyuScript/bilibili-api 项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-api