large-file-upload-sdk 3.6.1

Large File Upload SDK - Support chunked upload, resumable transfer, and Token authentication

File Upload SDK

上传文件到阿里云 OSS 的 Python SDK

安装

pip install large-file-upload-sdk

使用方法

1. 初始化 SDK

from file_upload_sdk import FileUploadSDK

sdk = FileUploadSDK(
    base_url="https://file-upload-server.ai4s.com.cn/",  # 服务地址
    user_id=12345,            # 你的用户ID（从平台个人中心获取）
    user_name="张三",          # 你的用户名
)

参数	说明	获取方式
base_url	上传服务地址	由管理员提供
user_id	用户ID	登录平台后在个人中心查看
user_name	用户名	你的平台用户名
dataset_id	数据集ID	在平台创建数据集后获取

2. 上传文件夹

result = sdk.upload_folder(
    folder_path="/path/to/your/folder",       # 本地文件夹路径
    dataset_id="419390545334853632",           # 目标数据集ID
)

print(f"总计: {result['total']}, 成功: {result['succeeded']}, 失败: {result['failed_count']}")

3. 上传单个文件

result = sdk.upload_file(
    file_path="/path/to/file.tar.gz",          # 本地文件路径
    dataset_id="419390545334853632",           # 目标数据集ID
)

if result["success"]:
    print(f"上传成功! 路径: {result.get('file_path', '')}")
else:
    print(f"上传失败: {result['error']}")

注意事项

关于压缩包： 平台数据集默认为只读挂载，不支持在数据集目录中原地解压。建议上传时直接上传整个目录（使用 upload_folder），无需打包压缩。如需解压使用，请先将文件复制到个人可写目录后再解压。

常见问题

中断了怎么办？ 重新执行同样的命令即可，已上传的文件会自动跳过。

支持多大的文件/目录？ 单文件最大 5TB，目录大小无限制。

ossutil 需要手动安装吗？ 不需要，首次上传文件夹时会自动下载安装。