投稿

上传封面

https://member.bilibili.com/x/vu/web/cover/up

请求方式: POST

认证方式：Cookie(SESSDATA)

注: 目前看来上传的图片似乎不会自动删除

URL参数:

参数名	类型	内容	必要性	备注
ts	num	当前时间	不必要	UNIX 毫秒时间戳

正文参数(application/x-www-form-urlencoded):

参数名	类型	内容	必要性	备注
csrf	str	CSRF Token (位于 Cookie 中 bili_jct)	必要
cover	base64	视频封面	必要	经过 base64 编码的图片数据

JSON回复:

根对象:

字段	类型	内容	备注
code	num	返回值	0: 成功 -400: 请求错误 -111: csrf 校验失败 -101: 账号未登录
message	str	错误信息	默认为 0
ttl	num	1
data	obj	信息本体

data 对象:

字段	类型	内容	备注
url	str	封面 URL

示例:

假设已经把需要发送的数据进行编码存放在文件 ./b64 中:

csrf=xxxxxxxxxxxx&cover=data%3Aimage%2Fjpeg%3Bbase64%2C%2F9j%2F4AAQSkZJRgABA...

发送请求:

curl -X POST --url "https://member.bilibili.com/x/vu/web/cover/up" \
--url-query "ts=$(date +%s%3N)" \
--data-binary @b64 \
-b "SESSDATA=xxxxxx; bili_jct=xxxxxx"

JavaScript (Node.js) 请求示例open in new window

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "url": "https://archive.biliimg.com/bfs/archive/77906db03b1eefac02613de184afad03f7bc58d7.jpg"
  }
}

预测稿件类型

https://member.bilibili.com/x/vupre/web/archive/types/predict

请求方式: POST

认证方式: Cookie(SESSDATA)

URL参数:

参数名	类型	内容	必要性	备注
ts	num	当前时间	不必要	UNIX 毫秒时间戳
csrf	str	CSRF Token (位于 Cookie 中 bili_jct)	必要

正文参数(multipart/form-data):

参数名	类型	内容	必要性	备注
filename	str	视频文件名	必要	从视频上传接口获取, 无后缀名, 可为空
title	str	视频标题	不必要
upload_id	str	上传 ID	不必要	如 `616368979_1723455540876_8794`

JSON回复:

根对象:

字段	类型	内容	备注
code	num	返回值	0: 成功 -400: 请求错误 -111: csrf 校验失败 -101: 账号未登录
message	str	错误信息	默认为 0
ttl	num	1
data	array	信息本体

data 数组:

项	类型	内容
0	obj	视频类型 1
1	obj	视频类型 2
……	obj	……
n	obj	视频类型 (n+1)

data 数组中的对象:

字段	类型	内容	备注
id	num	子分区 ID
parent	num	总分区 ID
parent_name	str	总分区名称
name	str	子分区名称
description	str	子分区描述
desc	str	子分区描述	同 `description`
intro_original	str	原创简介说明
intro_copy	str	转载简介说明
notice	str	注意事项
copy_right	num	版权信息?	0
show	bool	是否显示?	true
rank	num	排序权重?
max_video_count	num	最大视频数量?
request_id	str	空

示例:

curl -X POST --url 'https://member.bilibili.com/x/vupre/web/archive/types/predict' \
--url-query 'csrf=d51eadf05ba3bc6c5f76def7fbcc0185' \
--data-urlencode 'filename=' \
-b 'SESSDATA=xxx; bili_jct=xxx'

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": [
    {
      "id": 122,
      "parent": 36,
      "parent_name": "知识",
      "name": "野生技能协会",
      "description": "技能展示或技能教学分享类视频",
      "desc": "技能展示或技能教学分享类视频",
      "intro_original": "可对视频内容进行补充说明，并对所使用的视频素材进行标明。\n如是系列，也可附带上期视频地址。\n请勿加入涉政或具较大争议性的文字简介，否则将做打回处理。",
      "intro_copy": "转载稿件需标明出处，请注明原作者、原作者频道名或原作者投稿地址。\n可对相关内容进行补充说明。\n请勿加入涉政或具较大争议性的文字简介，否则将做打回处理。\n如是系列，也可附带上期视频地址。",
      "notice": "清晰明了表明内容亮点的标题会更受观众欢迎哟！",
      "copy_right": 0,
      "show": true,
      "rank": 75,
      "max_video_count": 100,
      "request_id": ""
    },
    {
      "id": 21,
      "parent": 160,
      "parent_name": "生活",
      "name": "日常",
      "description": "一般日常向的生活类视频",
      "desc": "一般日常向的生活类视频",
      "intro_original": "能够选择自制的必须是up主个人或工作室自己制作剪辑的视频，除此之外的搬运视频字幕制作，对于视频进行加速、慢放等简易二次创作，在视频中添加前后贴片或者打水印等行为均不被认作自制",
      "intro_copy": "转载需写明请注明转载作品详细信息原作者、原标题及出处（需为该视频最原始出处，如所标注明显为非原始出处的话会被打回）",
      "notice": "",
      "copy_right": 0,
      "show": true,
      "rank": 4,
      "max_video_count": 50,
      "request_id": ""
    },
    {
      "id": 242,
      "parent": 5,
      "parent_name": "娱乐",
      "name": "娱乐粉丝创作",
      "description": "粉丝向创作视频",
      "desc": "粉丝向创作视频",
      "intro_original": "",
      "intro_copy": "",
      "notice": "清晰明了表明内容亮点的标题会更受观众欢迎哟！",
      "copy_right": 0,
      "show": true,
      "rank": 40,
      "max_video_count": 50,
      "request_id": ""
    },
    {
      "id": 65,
      "parent": 4,
      "parent_name": "游戏",
      "name": "网络游戏",
      "description": "多人在线游戏为主要内容的相关视频",
      "desc": "多人在线游戏为主要内容的相关视频",
      "intro_original": "建议在简介和TAG中添加正确的游戏名，以便在分区和搜索中得到更好的展示。\n录制他人直播（包括授权转载、授权录制）不属于自制内容，请选转载。",
      "intro_copy": "建议在简介和TAG中添加正确的游戏名。\n搬运转载内容请添加原作者、原链接地址信息。录制他人直播内容请添加原主播信息、直播时间。\n未添加正确转载、录播信息的稿件可能被打回。",
      "notice": "【UP主/节目名】+《游戏名》+主要标题+期号",
      "copy_right": 0,
      "show": true,
      "rank": 30,
      "max_video_count": 50,
      "request_id": ""
    },
    {
      "id": 138,
      "parent": 160,
      "parent_name": "生活",
      "name": "搞笑",
      "description": "搞笑挑战、剪辑、表演、配音以及各类日常沙雕视频",
      "desc": "搞笑挑战、剪辑、表演、配音以及各类日常沙雕视频",
      "intro_original": "能够选择自制的必须是up主个人或工作室自己制作剪辑的视频，除此之外的搬运视频字幕制作，对于视频进行加速、慢放等简易二次创作，在视频中添加前后贴片或者打水印等行为均不被认作自制",
      "intro_copy": "转载需写明请注明转载作品详细信息原作者、原标题及出处（需为该视频最原始出处，如所标注明显为非原始出处的话会被打回）",
      "notice": "",
      "copy_right": 0,
      "show": true,
      "rank": 30,
      "max_video_count": 50,
      "request_id": ""
    }
  ]
}

预测稿件标签

https://member.bilibili.com/x/vupre/web/tag/recommend

请求方式: GET

认证方式: Cookie(SESSDATA)

URL参数:

参数名	类型	内容	必要性	备注
upload_id	str	同预测稿件类型的 `upload_id`	不必要
subtype_id	int	子分区 ID	不必要
title	str	视频标题	不必要
filename	str	同预测稿件类型的 `filename`	不必要
description	str	视频简介	不必要
cover_url	str	视频封面 URL	不必要	不含 `https:` 或 `http:` 字串
t	int	当前 UNIX 毫秒时间戳	不必要

JSON回复:

根对象:

字段	类型	内容	备注
code	int	返回值	0: 成功 -101: 账号未登录
data	array	标签信息
message	str	错误信息	默认为 0
request_id	str	请求 ID

data 数组:

项	类型	内容
0	obj	标签 1
1	obj	标签 2
……	obj	……
n	obj	标签 (n+1)

data 数组中的对象:

字段	类型	内容	备注
tag	str	标签名称
checked	int	0
request_id	str	请求 ID	同根对象

示例:

curl -G 'https://member.bilibili.com/x/vupre/web/tag/recommend' \
--url-query 'subtype_id=122' \
--url-query 'title=Telnet手打HTTP' \
--url-query 'description=测试用 Telnet 手打 HTTP/1.x 协议访问本地服务器, 无 SSL/TLS 支持'
-b 'SESSDATA=xxx'

查看响应示例:

{
  "code": 0,
  "data": [
    {
      "tag": "学习",
      "checked": 0,
      "request_id": "TAG_1723543336295_3371"
    },
    {
      "tag": "编程",
      "checked": 0,
      "request_id": ""
    },
    {
      "tag": "课程",
      "checked": 0,
      "request_id": ""
    },
    {
      "tag": "学习心得",
      "checked": 0,
      "request_id": ""
    },
    {
      "tag": "经验分享",
      "checked": 0,
      "request_id": ""
    }
  ],
  "message": "0",
  "request_id": "TAG_1723543336295_3371"
}

投递视频稿件

https://member.bilibili.com/x/vu/web/add/v3

请求方式: POST

认证方式：Cookie(SESSDATA)

URL参数:

参数名	类型	内容	必要性	备注
ts	num	当前时间	不必要	UNIX 毫秒时间戳
csrf	str	CSRF Token (位于 Cookie 中 bili_jct)	必要

正文参数(application/json):

根对象:

参数名	类型	内容	必要性	备注
videos	array	视频信息	必要	若为分 P 视频, 请注意数组元素顺序
cover	str	视频封面 URL	必要	参见上传视频封面
cover43	str	视频封面 URL (比例为 4:3)	必要	可为空
title	str	视频标题	必要	最多 80 字
copyright	num	1: 自制 2: 转载	必要
tid	num	分类 ID	必要
tag	str	视频标签	必要	多个标签用 `,` 分隔, 最多 10 个
desc_format_id	num	简介格式 ID?	必要	9999: 纯文本
desc	str	视频简介	必要	最多 2000 字
recreate	num	是否允许二创	必要	-1: 允许(默认) 1: 不允许
dynamic	str	粉丝动态	必要
interactive	num	互动视频?	必要	0: 否
act_reserve_create	num	活动预约?	必要	0: 否
no_disturbance	num	勿扰模式?	必要	0: 否
no_reprint	num	是否允许转载	必要	1: 允许 0: 不允许
subtitle	obj	字幕信息	必要
dolby	num	杜比音效	必要	0: 否(默认) 1: 是
lossless_music	num	无损音乐	必要	0: 否(默认) 1: 是
up_selection_reply	bool	精选评论	必要
up_close_reply	bool	关闭评论	必要
up_close_danmu	bool	关闭弹幕	必要
web_os	num	平台类型?	必要	3

videos 数组中的对象:

参数名	类型	内容	必要性	备注
filename	str	视频文件名	必要	从视频上传接口获取, 无后缀名
title	str	分 P 标题	必要
desc	str	分 P 简介	必要
cid	num	分 P cid	必要	从视频上传接口获取, 即 `biz_id`

subtitle 对象:

参数名	类型	内容	必要性	备注
open	num	是否启用字幕投稿	必要	0: 启用(默认) 1: 不启用
lan	str	字幕投稿语言	必要	可为空

示例:

假设已经把需要发送的数据存放在文件 ./data.json 中:

{
  "videos": [
    {
      "filename": "n240728ad33h52yqhxbtw51cb06sq9gx",
      "title": "Telnet手打HTTP",
      "desc": "",
      "cid": 500001629877726
    }
  ],
  "cover": "https://archive.biliimg.com/bfs/archive/85447ea20431ef799382c403c84b4bfb82a41053.jpg",
  "cover43": "",
  "title": "Telnet手打HTTP",
  "copyright": 1,
  "tid": 122,
  "tag": "telnet,socket,tcp,linux,http",
  "desc_format_id": 9999,
  "desc": "测试用 Telnet 手打 HTTP/1.x 协议访问本地服务器, 无 SSL/TLS 支持",
  "recreate": -1,
  "dynamic": "for testing",
  "interactive": 0,
  "act_reserve_create": 0,
  "no_disturbance": 0,
  "no_reprint": 1,
  "subtitle": {
    "open": 0,
    "lan": ""
  },
  "dolby": 0,
  "lossless_music": 0,
  "up_selection_reply": false,
  "up_close_reply": false,
  "up_close_danmu": false,
  "web_os": 3,
  "csrf": "xxxxxxxxxxxxxxxxxxxxxxxx"
}

发送请求:

curl -X POST --url "https://member.bilibili.com/x/vu/web/add/v3" \
--url-query "ts=$(date +%s%3N)" \
--url-query "csrf=xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json; charset=utf-8" \
--data @data.json \
-b "SESSDATA=xxxxxx; bili_jct=xxxxxxxxxxxxxxxxxxxxxxxx"

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "aid": 112861976201494,
    "bvid": "BV181vnexEmB"
  }
}

上传视频文件

注: 目前看来上传的视频文件似乎不会自动删除, 而且似乎不是视频也可以上传的样子, 但是下载认证字段有效期只有 5 天

上传流程

整个上传流程较为复杂, 详细参见Demo

GET preupload 接口, 获取上传元数据
POST 第 1 步得到的地址, 上传视频元数据
PUT 第 1 步得到的地址, 分片上传视频文件
POST 第 1 步得到的地址, 结束上传视频文件
GET 第 1 步得到的地址, 下载已上传的视频文件 , 确认上传成功 (可选)

上传接口

获取上传元数据 (预上传)

https://member.bilibili.com/preupload

请求方式: GET

认证方式：Cookie(SESSDATA)

URL参数:

参数名	类型	内容	必要性	备注
name	str	文件名	必要	会影响返回的上传地址
r	str	上传区域?	必要	upos
profile	str	上传配置?	必要	普通视频: ugcfx/bup 提交反馈: feedback/bup
probe_version	num	上传版本?	不必要	20221109
upcdn	str	上传 CDN?	不必要	txa
zone	str	上传区域?	不必要	cs
ssl	num	是否使用 SSL?	不必要	0
version	str	上传版本?	不必要	2.14.0.0
build	str	上传版本?	不必要	2140000
size	num	文件大小	不必要	视频文件大小, 单位字节
webVersion	str	上传版本?	不必要	2.13.0

JSON回复:

根对象:

字段	类型	内容	备注
OK	num	1
auth	str	上传凭证	作为后面请求中请求头, 有效期 5 天
biz_id	num	业务 ID?
chunk_retry	num	重试次数?
chunk_retry_delay	num	重试延迟?
chunk_size	num	分块大小	后面要用
endpoint	str	上传节点	后面要用
endpoints	array	上传节点列表
expose_params	null
put_query	str	上传参数?
threads	num	上传线程数
timeout	num	超时时间?
uip	str	你的 IP
upos_uri	str	上传地址	后面要用

endpoints 数组:

项	类型	内容
0	str	上传节点1
……	str	……
n	str	上传节点n

示例:

假设视频文件名为 2024-07-28_15-37-50.mkv, 视频大小为 305333744 字节

curl -G "https://member.bilibili.com/preupload" \
--data-urlencode "name=2024-07-28_15-37-50.mkv" \
--data-urlencode "r=upos" \
--data-urlencode "profile=ugcfx/bup" \
-b "SESSDATA=xxxxxxxxxxx"

查看响应示例:

{
  "OK": 1,
  "auth": "ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=b6c5cc520a281200906aea97e190b098&timestamp=1722155211.324&uid=616368979&uip=108.181.24.77&uport=52096&use_dqp=0",
  "biz_id": 500001630152509,
  "chunk_retry": 10,
  "chunk_retry_delay": 3,
  "chunk_size": 10485760,
  "endpoint": "//upos-cs-upcdntxa.bilivideo.com",
  "endpoints": [
    "//upos-cs-upcdntxa.bilivideo.com",
    "//upos-cs-upcdnalia.bilivideo.com"
  ],
  "expose_params": null,
  "put_query": "os=upos&profile=ugcfx%2Fbup",
  "threads": 3,
  "timeout": 1200,
  "uip": "108.181.24.77",
  "upos_uri": "upos://ugcfx2lf/n240728ad1p51if4g3ke4s3o95sznogy.mkv"
}

上传视频元数据

URL 拼接格式: "https" + 上一个接口的endpoint + 上一个接口的upos_uri去掉协议名
JavaScript 模板字符串: https:${preupload.endpoint}/${endpoint.upos_uri.replace("upos://", "")}

请求方式: POST

认证方式：请求头 X-Upos-Auth 为上一接口得到的 auth

URL参数:

参数名	类型	内容	必要性	备注
uploads	str	留空	必要	留空
output	str	输出格式	不必要	默认为 json(推荐), 留空为 xml
profile	str	上传配置?	必要	与上一个接口保持相同
filesize	num	文件大小	必要	视频文件大小, 单位字节 feedback/bup 不必要
partsize	num	分块大小	必要	上一个接口返回, 且后面要用 feedback/bup 不必要
biz_id	num	业务 ID?	必要	上一个接口返回, 且后面要用 feedback/bup 不必要

JSON回复:

根对象:

字段	类型	内容	备注
OK	num	1
bucket	str	空间名?
key	str	文件名?
upload_id	str	上传 ID	后面要用

示例:

假设上一接口返回的 auth 为 ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=4004b35628e982bc90b59cec86f8c441&timestamp=1722173443.298&uid=616368979&uip=104.28.153.18&uport=44282&use_dqp=0, biz_id 为500001630454700, endpoint 为 //upos-cs-upcdntxa.bilivideo.com, upos_uri 为 upos://ugcfx2lf/n240728adhejliqv0kqyg2s5n6huv501.mkv, chunk_size 为 10485760. 视频文件大小为 305333744 字节.

curl -X POST --url "https://upos-cs-upcdntxa.bilivideo.com/ugcfx2lf/n240728adhejliqv0kqyg2s5n6huv501.mkv` \
--url-query "uploads=" \
--url-query "output=json" \
--url-query "profile=ugcfx/bup" \
--url-query "filesize=305333744" \
--url-query "partsize=10485760" \
--url-query "biz_id=500001630454700" \
-H "X-Upos-Auth: ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=4004b35628e982bc90b59cec86f8c441&timestamp=1722173443.298&uid=616368979&uip=104.28.153.18&uport=44282&use_dqp=0" \
-b "SESSDATA=xxxxxxxxx"

查看响应示例:

{
  "OK": 1,
  "bucket": "ugcfx2lf",
  "key": "/n240728adhejliqv0kqyg2s5n6huv501.mkv",
  "upload_id": "26c674b4-0dce-45f5-a9cd-a199d9c982bf"
}

分片上传视频文件

URL 同上一个接口

请求方式: PUT

认证方式：请求头 X-Upos-Auth 为上上一接口得到的 auth

URL参数:

参数名	类型	内容	必要性	备注
partNumber	num	分块序号	必要	从 1 开始
uploadId	str	上传 ID	必要	上一个接口返回
chunk	num	分块序号	必要	从 0 开始
chunks	num	分块总数	必要	自行计算: 文件大小除以分块大小并向上取整
size	num	该分块大小	必要	该实际上传字节数
start	num	该分块开始位置	必要	已实际上传字节数
end	num	该分块结束位置	必要	该分块上传结束后实际上传总字节数
total	num	总大小	必要	视频文件大小, 单位字节

正文参数(application/octet-stream):

视频文件在该分块的字节流

纯文本回复:

MULTIPART_PUT_SUCCESS

示例:

假设上上一接口返回的 auth 为 ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0, endpoint 为 //upos-cs-upcdntxa.bilivideo.com, upos_uri 为 upos://ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz, chunk_size 为 10485760.

上一接口返回的 upload_id 为 8130090a-16f7-4fe6-8a29-198f5abce913.

视频文件名为 20240724-remove-linux-then-install.tar.xz, 文件大小为 278255704 字节.

假设您要上传的分块序号为 1, 该分块大小为 10485760, 该分块开始位置为 0, 该分块结束位置为 10485760, 该分块实际上传字节数为 10485760, 您已将文件分块存放至 part01.tar.xz, part02.tar.xz, ..., part27.tar.xz.

curl -X PUT --url "https://upos-cs-upcdntxa.bilivideo.com/ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz" \
--url-query "partNumber=1" \
--url-query "uploadId=8130090a-16f7-4fe6-8a29-198f5abce913" \
--url-query "chunk=0" \
--url-query "chunks=27" \
--url-query "size=10485760" \
--url-query "start=0" \
--url-query "end=10485760" \
--url-query "total=278255704" \
-H "X-Upos-Auth: ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0" \
-H "Content-Type: application/octet-stream" \
--data-binary @part01.tar.xz \
-b "SESSDATA=xxxxxxxxx"

查看响应示例:

MULTIPART_PUT_SUCCESS

结束上传视频文件

URL 同上一个接口

请求方式: POST

认证方式：请求头 X-Upos-Auth 为上上上一接口得到的 auth

URL参数:

参数名	类型	内容	必要性	备注
output	str	输出格式	不必要	默认为 json(推荐), 留空为 xml
name	str	文件名	必要	视频文件名
profile	str	上传配置?	必要	与上一个接口相同, 普通视频: ugcfx/bup
uploadId	str	上传 ID	必要	与上一个接口相同
biz_id	num	业务 ID?	必要	与上上一个接口相同

正文参数(application/json):

根对象:

参数名	类型	内容	必要性	备注
parts	array	各分块信息	必要	按实际上传顺序而不是分块序号顺序

parts 数组:

项	类型	内容	必要性	备注
0	obj	分块信息1	必要	按实际上传顺序而不是分块序号顺序
1	obj	分块信息2	必要
……	obj	……
n	obj	分块信息n	必要

parts 数组中的对象:

参数名	类型	内容	必要性	备注
partNumber	num	分块序号	必要	从 1 开始
eTag	str	`etag`	必要

JSON回复:

与上上一个接口相同

示例:

假设上上上一接口返回的 auth 为 ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0, endpoint 为 //upos-cs-upcdntxa.bilivideo.com, upos_uri 为 upos://ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz, biz_id 为 500001630826789.

上上一接口返回的 upload_id 为 8130090a-16f7-4fe6-8a29-198f5abce913.

视频文件名为 20240724-remove-linux-then-install.tar.xz, 文件大小为 278255704 字节.

假设您已经全部上传完毕, 共上传 27 个分块, 本次请求上传的的内容存放在 body.json 文件中.

curl -X PUT --url "https://upos-cs-upcdntxa.bilivideo.com/ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz" \
--url-query "output=json" \
--url-query "name=20240724-remove-linux-then-install.tar.xz" \
--url-query "profile=ugcfx%2Fbup" \
--url-query "uploadId=8130090a-16f7-4fe6-8a29-198f5abce913" \
--url-query "biz_id=500001630826789" \
-H "X-Upos-Auth: ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0" \
-H "Content-Type: application/json" \
--data-binary @body.json \
-b "SESSDATA=xxxxxxxxx"

查看响应示例:

{
  "OK": 1,
  "location": "ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz",
  "bucket": "ugcfx2lf",
  "key": "/n240729ad7gxi43yaoml312h2nbt2pnf.xz"
}

下载已上传的视频文件

URL 同上一个接口

请求方式: GET

认证方式：请求头 X-Upos-Auth 为上上上上一接口得到的 auth

注: 由于 X-Upos-Auth 有效期只有 5 天, 过期请求将返回 HTTP 403 如下

HTTP/1.1 403 Forbidden
Bili-Trace-Id: 3e3f2db61366adbf
Server: upos@hcsgw@jscs-bvc-hcsgw-public-02
X-Bili-Trace-Id: 0d8ca1af6d3510253e3f2db61366adbf
X-Upos-Auth: AUTH_TS_GT_5DAY AUTH=ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0 Now=1722662669 DURATION=449893
Content-Length: 0
Connection: keep-alive
Date: Sat, 03 Aug 2024 05:24:29 GMT
EO-LOG-UUID: 4296647794590631154
EO-Cache-Status: MISS

字节流回复:

视频文件字节流

示例:

假设请求上一接口时的 URL 为 https://upos-cs-upcdntxa.bilivideo.com/ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz, 请求头的 X-Upos-Auth 为 ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0, 您想要下载到运行目录下的 file.tar.xz 文件

curl -G "https://upos-cs-upcdntxa.bilivideo.com/ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz" \
-H "X-Upos-Auth: ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0" \
--output file.tar.xz

查看检查示例:

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  265M  100  265M    0     0  9493k      0  0:00:28  0:00:28 --:--:-- 10.3M
$ sha512sum file.tar.xz
abfbedf1ac4f251c81103beb4d5406af1e0b64b9d54e99bfc77d2a8a9c4913a9fd2f1751828ace8aac036f6385609d99e251437b07a0491caca2ad7069a57003  file.tar.xz
$ sha512sum ~/Documents/video-proj/20240724-remove-linux-then-install.tar.xz
abfbedf1ac4f251c81103beb4d5406af1e0b64b9d54e99bfc77d2a8a9c4913a9fd2f1751828ace8aac036f6385609d99e251437b07a0491caca2ad7069a57003  /home/sess/Documents/video-proj/20240724-remove-linux-then-install.tar.xz

Demo

Java

注: 需要 Gson 依赖, Java 8+, 单线程上传, 无异常处理, 仅供参考

import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.StringJoiner;

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonArray;
import com.google.gson.JsonObject;
import com.google.gson.JsonSyntaxException;

/**
 * A demo class for uploading videos to Bilibili.
 * 
 * @author SessX6cf
 */
public class BiliVideoUploader {

  private static String SESSDATA;
  private static File VIDEO_FILE;

  public static void main(String[] args) throws IOException {
    long ts = System.currentTimeMillis();
    if (args.length < 2) {
      System.out.println("Usage: java BiliVideoUploader <video_file> <sessdata>");
      return;
    } else {
      VIDEO_FILE = new File(args[0]);
      if (!VIDEO_FILE.isFile()) {
        System.out.println("It is not a file!");
        return;
      } else if (!VIDEO_FILE.canRead()) {
        System.out.println("Cannot read the file!");
        return;
      } else if (VIDEO_FILE.isDirectory()) {
        System.out.println("You can play a directory?!");
        return;
      }
      SESSDATA = args[1];
    }
    // step 1: preupload video
    System.out.println("step 1: preupload video");
    JsonObject preuploadVideo = preuploadVideo();
    // step 2: post video meta
    System.out.println("step 2: post video meta");
    JsonObject postVideoMeta = postVideoMeta(preuploadVideo);
    // step 3: upload video
    System.out.println("step 3: upload video");
    int chunks = uploadVideo(preuploadVideo, postVideoMeta);
    // step 4: end upload
    System.out.println("step 4: end upload");
    endupload(preuploadVideo, postVideoMeta, chunks);
    // finished
    System.out.println("finished (" + (System.currentTimeMillis() - ts) + "ms)");
  }

  private static String querypart(String key, String value) throws IOException {
    return key + "=" + URLEncoder.encode(value, "UTF-8");
  }

  private static HttpURLConnection conn(String url, String method) throws IOException {
    HttpURLConnection conn;
    try {
      conn = (HttpURLConnection) new URI(url).toURL().openConnection();
    } catch (java.net.URISyntaxException e) {
      throw new IOException(e);
    }
    conn.setRequestMethod(method);
    // conn.setRequestProperty("User-Agent", "Mozilla/5.0 (X11; Linux x86_64; rv:109.0) Gecko/20100101 Firefox/115.0");
    if (url.contains("bilibili.com")) conn.setRequestProperty("Cookie", "SESSDATA=" + SESSDATA);
    return conn;
  }

  private static byte[] inputStreamToString(HttpURLConnection conn) throws IOException {
    ByteArrayOutputStream baos = new ByteArrayOutputStream();
    InputStream in;
    in = conn.getInputStream();
    int b;
    while ((b = in.read()) != -1) {
      baos.write(b);
    }
    in.close();
    return baos.toByteArray();
  }

  private static final Gson GSON = new GsonBuilder().setPrettyPrinting().create();

  private static JsonObject preuploadVideo() throws IOException {
    StringJoiner url = new StringJoiner("&", "https://member.bilibili.com/preupload?", "");
    url.add(querypart("name", VIDEO_FILE.getName()));
    // url.add(querypart("size", String.valueOf(VIDEO_FILE.length())));
    url.add(querypart("r", "upos"));
    url.add(querypart("profile", "ugcfx/bup"));
    HttpURLConnection conn = conn(url.toString(), "GET");
    System.out.println("GET " + url.toString());
    String response = new String(inputStreamToString(conn), StandardCharsets.UTF_8);
    try {
      JsonObject json = GSON.fromJson(response, JsonObject.class);
      System.out.println(GSON.toJson(json));
      return json;
    } catch (JsonSyntaxException e) {
      System.out.println(response);
      throw e;
    }
  }

  private static JsonObject postVideoMeta(JsonObject preuploadVideo) throws IOException {
    String schemeandhost = "https:" + preuploadVideo.get("endpoint").getAsString();
    String path = preuploadVideo.get("upos_uri").getAsString().replaceFirst("upos:/", "");
    StringJoiner url = new StringJoiner("&", schemeandhost + path + "?", "");
    url.add(querypart("uploads", "")); // WARNING: this is not a typo, it's required, or 404
    url.add(querypart("output", "json"));
    url.add(querypart("profile", "ugcfx/bup"));
    url.add(querypart("filesize", String.valueOf(VIDEO_FILE.length())));
    url.add(querypart("partsize", preuploadVideo.get("chunk_size").getAsString()));
    url.add(querypart("biz_id", preuploadVideo.get("biz_id").getAsString()));
    HttpURLConnection conn = conn(url.toString(), "POST");
    conn.setRequestProperty("X-Upos-Auth", preuploadVideo.get("auth").getAsString()); // 403 without it
    System.out.println("POST " + url.toString());
    String response = new String(inputStreamToString(conn), StandardCharsets.UTF_8);
    try {
      JsonObject json = GSON.fromJson(response, JsonObject.class);
      System.out.println(GSON.toJson(json));
      return json;
    } catch (JsonSyntaxException e) {
      System.out.println(response);
      throw e;
    }
  }

  private static int uploadVideo(JsonObject preuploadVideo, JsonObject postVideoMeta) throws IOException {
    long startts = System.currentTimeMillis() - 1;
    String schemeandhost = "https:" + preuploadVideo.get("endpoint").getAsString();
    String path = preuploadVideo.get("upos_uri").getAsString().replaceFirst("upos:/", "");
    String urlp = schemeandhost + path + "?";
    long length = VIDEO_FILE.length();
    byte[] buffer = new byte[preuploadVideo.get("chunk_size").getAsInt()];
    int size = 0;
    int chunks = (int) Math.ceil(length / (double) buffer.length);
    InputStream in = new FileInputStream(VIDEO_FILE);
    for (int chunk = 0; chunk < chunks; chunk++) {
      System.out.println("speed: " + (chunk * buffer.length) / (System.currentTimeMillis() - startts) + "bytes/s");
      System.out.println("chunk: " + (chunk + 1) + "/" + chunks);
      size = in.read(buffer, 0, buffer.length);
      if (size == -1) {
        break;
      }
      StringJoiner url = new StringJoiner("&", urlp, "");
      url.add(querypart("partNumber", String.valueOf(chunk + 1)));
      url.add(querypart("uploadId", postVideoMeta.get("upload_id").getAsString()));
      url.add(querypart("chunk", String.valueOf(chunk)));
      url.add(querypart("chunks", String.valueOf(chunks)));
      url.add(querypart("size", String.valueOf(size)));
      url.add(querypart("start", String.valueOf(chunk * buffer.length)));
      url.add(querypart("end", String.valueOf((chunk) * buffer.length + size)));
      url.add(querypart("total", String.valueOf(length)));
      HttpURLConnection conn = conn(url.toString(), "PUT");
      conn.setRequestProperty("X-Upos-Auth", preuploadVideo.get("auth").getAsString());
      conn.setRequestProperty("Content-Type", "application/octet-stream");
      conn.setRequestProperty("Content-Length", String.valueOf(size));
      conn.setDoOutput(true);
      conn.getOutputStream().write(buffer, 0, size);
      System.out.println("PUT " + url.toString());
      String response = new String(inputStreamToString(conn), StandardCharsets.UTF_8);
      System.out.println(response);
    }
    in.close();
    return chunks;
  }

  private static void endupload(JsonObject preuploadVideo, JsonObject postVideoMeta, int chunks) throws IOException {
    String schemeandhost = "https:" + preuploadVideo.get("endpoint").getAsString();
    String path = preuploadVideo.get("upos_uri").getAsString().replaceFirst("upos:/", "");
    StringJoiner url = new StringJoiner("&", schemeandhost + path + "?", "");
    url.add(querypart("output", "json"));
    url.add(querypart("name", VIDEO_FILE.getName()));
    url.add(querypart("profile", "ugcfx/bup"));
    url.add(querypart("uploadId", postVideoMeta.get("upload_id").getAsString()));
    url.add(querypart("biz_id", preuploadVideo.get("biz_id").getAsString()));
    JsonArray parts = new JsonArray();
    for (int i = 1; i <= chunks; i++) {
      JsonObject part = new JsonObject();
      part.addProperty("partNumber", i);
      part.addProperty("eTag", "etag");
      parts.add(part);
    }
    JsonObject body = new JsonObject();
    body.add("parts", parts);
    HttpURLConnection conn = conn(url.toString(), "POST");
    conn.setRequestProperty("X-Upos-Auth", preuploadVideo.get("auth").getAsString());
    conn.setRequestProperty("Content-Type", "application/json; charset=UTF-8");
    conn.setDoOutput(true);
    conn.getOutputStream().write(body.toString().getBytes(StandardCharsets.UTF_8));
    System.out.println("POST " + url.toString());
    String response = new String(inputStreamToString(conn), StandardCharsets.UTF_8);
    try {
      JsonObject json = GSON.fromJson(response, JsonObject.class);
      System.out.println(GSON.toJson(json));
    } catch (JsonSyntaxException e) {
      System.out.println(response);
      throw e;
    }
  }

}

# 投稿

# 上传封面

# 预测稿件类型

# 预测稿件标签

# 投递视频稿件

# 上传视频文件

# 上传流程

# 上传接口

# 获取上传元数据 (预上传)

# 上传视频元数据

# 分片上传视频文件

# 结束上传视频文件

# 下载已上传的视频文件

# Demo

# Java

投稿

上传封面

预测稿件类型

预测稿件标签

投递视频稿件

上传视频文件

上传流程

上传接口

获取上传元数据 (预上传)

上传视频元数据

分片上传视频文件

结束上传视频文件

下载已上传的视频文件

Demo

Java