// DEVELOPER SDK · v3.2.1

为开发者提供高速下载接口轻松集成批量下载能力

迅雷下载SDK为开发者提供完整的高速下载接口与JS-SDK组件,覆盖C++、Java、Python、JavaScript、TypeScript、Go等多语言,几行业务代码即可获得P2P加速、断点续传、多协议解析与分布式分发能力。

查看示例代码
example.js — JS-SDK浏览器版最小集成示例
// 引入迅雷JS-SDK(也可通过npm安装:@xunlei/sdk)
import { XL } from '@xunlei/sdk';

// 单任务下载:URL + 保存路径 + 进度回调
const task = XL.download({
  url: 'https://example.com/bigfile.zip',
  savePath: './downloads/bigfile.zip',
  protocol: 'auto',      // auto/http/ftp/magnet/ed2k
  parallel: 64,          // 最大并发连接数
  hashVerify: 'sha256',   // 完整性校验
  onProgress: (p) => {
    console.log(`已下载 ${(p.ratio*100).toFixed(1)}% · 速度 ${p.speed} MB/s`);
  },
  onComplete: () => console.log('任务完成'),
});

// 批量任务管理
const batch = XL.createBatch()
  .add(urls).parallel(4)           // 4个并发任务
  .retry(3).on('allDone', () => alert('全部完成'))
  .start();
// CORE.CAPABILITIES

六大核心能力 · 一行接入即用

从协议解析到分布式调度,迅雷下载SDK以最小集成成本提供工业级下载能力。

P2P加速引擎

SDK内置分布式P2P加速引擎,单任务并发数百连接拉取,平均速度提升5-20倍。

🔁

断点续传

分片粒度细化到512KB,断线重连秒级恢复,已下载分片持久化存储不丢失。

📡

多协议解析

HTTP/HTTPS、FTP、磁力链、电驴ed2k、Thunder私有协议自动识别与解析。

🛡️

安全校验

SHA256/MD5/CRC32多重哈希校验,分片级完整性保障,杜绝下载损坏。

实时统计

细粒度进度、速度、剩余时间回调,支持事件总线订阅全量下载指标。

🚀

批量任务

批量队列管理、并发控制、失败重试、任务优先级,一套API搞定所有场景。

// LANGUAGE.BINDINGS

多语言绑定 · 全场景覆盖

提供主流前后端语言原生绑定,接口语义一致,跨语言迁移零成本。

⚙️

C/C++

Java

🐍

Python

🟢

Node.js

TypeScript

🐹

Go

🦀

Rust

🐘

PHP

📱

Android

🍎

iOS/Swift

🌐

JS-Browser

🐧

C#/.NET

// REST.API

REST API · 完整接口文档

除本地SDK外,迅雷还提供云端REST API,无需集成客户端也能远程发起高速下载任务。

POST/v3/tasks/create创建下载任务
GET/v3/tasks/{id}/status查询任务进度
POST/v3/tasks/{id}/pause暂停任务
POST/v3/tasks/{id}/resume恢复任务
GET/v3/tasks/list列出全部任务
PUT/v3/tasks/{id}/limit动态限速
// USE.CASES

应用场景 · 赋能万千业务

从个人项目到企业级平台,迅雷下载SDK在各种业务场景中稳定运行。

📦

软件分发系统

企业内部软件、补丁包、镜像分发系统集成SDK,员工客户端极速下载升级。

🎬

影音内容平台

在线视频、音频、字幕等媒体资源后台批量下载、预处理、转码分发。

🎓

在线教育平台

网课视频、讲义、习题库资源由教师端一键上传,学员端SDK极速拉取。

🤖

AI数据采集

机器学习数据集、开源模型权重批量下载,分布式节点加速模型训练。

// METRICS

数据指标 · 见证开发者信赖

持续稳定的SDK服务,为开发者业务保驾护航。

50万+
注册开发者
20亿+
日均下载次数
99.99%
SDK可用性
12+
语言版本
// FAQ

常见问题 · 详细解答

接入迅雷下载SDK过程中的高频疑问,这里都有完整解答。

迅雷下载SDK支持哪些开发语言?
迅雷下载SDK提供覆盖主流后端与前端语言的完整接入方案:后端包含C/C++、Java、Python、Go、Rust、PHP;前端与脚本层提供JavaScript/TypeScript、Node.js浏览器端与Node.js服务器端双版本;移动端另有Android Java/Kotlin、iOS Objective-C/Swift封装。所有语言版本共享一致的接口语义,迁移成本极低。
SDK接入需要多少代码?
最小可用集成仅需3-5行业务代码:引入SDK包、传入下载链接与本地路径、注册进度回调。以JS-SDK浏览器版为例,引入script标签后调用XL.download(url, options, callback)即可发起任务,复杂场景下可启用断点续传、并发任务、限速等高级参数。
SDK是否商用授权收费?
SDK基础版对个人开发者与中小团队完全免费,包含HTTP/FTP协议解析、P2P加速、断点续传、多线程并发等全部核心能力。企业级商业版提供SLA保障、专属技术支持、私有化部署、定制功能开发等服务,具体资费可联系商务团队洽谈。
SDK下载速度相比自建下载有何优势?
自建下载通常受限于单服务器出口带宽,遇到高并发场景极易拥塞。迅雷下载SDK底层接入全球10000+加速节点与分布式P2P分享网络,单任务可并发数百条连接拉取,平均下载速度比传统HTTP下载快5-20倍,且自带CDN回源机制保障资源可用性。
SDK如何保障下载文件的安全与完整性?
SDK内置SHA256/MD5校验、文件签名校验、分片校验三重防护机制。每个下载任务自动按分片计算哈希,全部完成后比对整体哈希,校验失败的损坏分片自动重新拉取。同时支持对接第三方安全扫描接口,在下载完成后触发病毒查杀流程。
REST API鉴权如何使用?
REST API采用Token鉴权机制,开发者登录开放平台获取API Key,在HTTP请求头携带Authorization: Bearer {apiKey}即可。免费版默认QPS为10次/秒,商用版可申请提升至1000+ QPS,企业私有部署不限流。
是否提供离线下载与云端转存能力?
SDK支持离线下载模式,先由迅雷云端代为拉取热门与中等热度资源,再从云端高速取回本地。冷门资源与受限于本地网络环境的下载任务尤为有效。开发者可通过offline: true参数启用该模式,云端取回速度可达40+ MB/s。
SDK与商业授权的SLA如何?
免费版SDK不承诺SLA,商用版提供99.9%可用性SLA,年度合同可升级至99.99% SLA。SLA未达标按未达标时长×单价扣除服务费,所有SLA条款写入正式合同,由商务团队提供专属技术支持与企业微信群对接。

立即开始集成迅雷下载SDK

为开发者打造的高速下载接口,几行代码即可获得工业级下载能力。