Home Explore Help
Sign In
CN-bibi
/
bilibili--api
mirror of https://github.com/SocialSisterYi/bilibili-API-collect
Watch 1
Star 0
Fork 0
Files Issues 0 Wiki
Branch: master
Branches Tags
bilibili--api
/
docs
/
creativecenter
/
upload.md

upload.md 38 KB
Permalink History Raw

投稿

上传封面

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) 请求示例

查看响应示例:
{
  "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

  1. GET preupload 接口, 获取上传元数据

  2. POST 第 1 步得到的地址, 上传视频元数据

  3. PUT 第 1 步得到的地址, 分片上传视频文件

  4. POST 第 1 步得到的地址, 结束上传视频文件

  5. 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;
    }
  }

}