Bilibili API Go SDK

Bilibili API Go SDK，提供哔哩哔哩平台的全方位功能封装。

🌟 功能特性

🔐 认证登录

• 二维码登录 - QR码扫码登录，安全便捷
• 短信登录 - 手机号验证码登录
• 密码登录 - 用户名密码登录
• Cookie认证 - 基于已有Cookie的认证
• WBI签名 - 自动处理B站WBI签名验证

📊 视频管理

• 视频上传 - 支持分片上传和断点续传
• 🚀 并发上传（NEW） - 3线程并发上传，速度提升2-3倍
• 从URL上传 - 直接从腾讯COS等云存储URL上传
• 智能Endpoint选择 - 自动选择最优上传节点
• 封面上传 - 视频封面图片上传
• 视频投稿 - 完整的视频发布流程
• 投稿审核状态 - 查询视频是否通过审核
• 视频编辑 - 修改视频信息（标题、简介、标签等）
• 视频删除 - 删除已发布视频
• 视频列表 - 获取个人视频列表

🏷️ 标签管理

• 标签验证 - 检查标签是否有效
• 推荐标签 - 基于内容获取推荐标签
• 标签搜索 - 搜索相关标签
• 批量验证 - 批量验证多个标签
• 标签格式化 - 自动格式化为B站要求格式

📊 数据统计

• 视频统计 - 播放量、点赞、收藏等数据
• 用户统计 - 粉丝、关注、获赞等统计
• UP主统计 - 创作者数据概览
• 详细分析 - 视频详细分析数据（需登录）
• 趋势数据 - 时间段内的数据趋势

🎥 直播功能

• 直播间信息 - 获取直播间详细信息
• 直播流信息 - 获取直播流地址和画质
• 开始直播 - 启动直播推流
• 停止直播 - 结束直播
• 更新标题 - 修改直播间标题

🛠️ 创作者工具

• 创作者信息 - 获取创作者基本信息
• 草稿管理 - 保存、删除、列表草稿
• 合集管理 - 获取合集、创建合集、编辑合集和小节
• 模板管理 - 创建和使用视频模板
• 批量操作 - 批量处理视频内容

� 用户信息

• 基本信息 - 获取用户基本资料
• 详细信息 - 获取用户详细信息
• 个人空间 - 访问用户空间数据

🚀 快速开始

安装

go get github.com/difyz9/bilibili-go-sdk

基本使用

1. 二维码登录

package main

import (
    "fmt"
    "log"
    "time"
    
    "github.com/difyz9/bilibili-go-sdk/bilibili"
)

func main() {
    // 创建客户端
    client := bilibili.NewClient()
    
    // 获取二维码
    qrResp, err := client.GetQRCode()
    if err != nil {
        log.Fatal(err)
    }
    
    fmt.Printf("请扫描二维码: %s\n", qrResp.Data.URL)
    
    // 轮询登录状态
    for {
        loginInfo, err := client.PollQRCode(qrResp.Data.AuthCode)
        if err == nil {
            fmt.Printf("登录成功! 用户: %s\n", loginInfo.TokenInfo.Uname)
            cookies := loginInfo.GetCookieString()
            fmt.Printf("Cookies: %s\n", cookies)
            break
        }
        
        time.Sleep(3 * time.Second)
    }
}

2. 短信登录

// 发送短信验证码
smsResp, err := client.SendSMS("13800138000", "86")
if err != nil {
    log.Fatal(err)
}

// 使用验证码登录
loginReq := &bilibili.SMSLoginRequest{
    Tel:      "13800138000",
    Cid:      "86",
    Code:     "123456", // 用户输入的验证码
    LoginKey: smsResp.CaptchaKey,
}

loginResp, err := client.SMSLogin(loginReq)
if err != nil {
    log.Fatal(err)
}

fmt.Printf("登录成功! Cookies: %s\n", loginResp.CookieInfo.Cookies)

3. Cookie认证

// 使用已有的Cookie进行认证
cookies := "buvid3=...; bili_jct=...; SESSDATA=..."
auth := bilibili.NewCookieAuth(cookies)

if auth.IsValid() {
    fmt.Println("Cookie认证成功")
    userInfo, _ := auth.GetUserInfo()
    fmt.Printf("当前用户: %s\n", userInfo.Name)
}

4. 合集管理

cookies := "SESSDATA=...; bili_jct=..."

client := bilibili.NewClient()

seasonID, err := client.CreateSeason(&bilibili.SeasonCreateRequest{
    Title: "我的合集",
    Desc:  "合集简介",
    Cover: "https://i0.hdslb.com/bfs/archive/example.jpg",
}, cookies)
if err != nil {
    log.Fatal(err)
}

detail, err := client.GetSeasonSection(seasonID, cookies)
if err != nil {
    log.Fatal(err)
}

fmt.Printf("合集小节: %+v\n", detail.Section)

fmt.Printf("登录成功! 用户: %s\n", loginInfo.TokenInfo.Uname)

// 获取用户信息
userInfo, err := client.GetMyInfo(loginInfo.GetCookieString())
if err != nil {
    log.Fatal(err)
}

fmt.Printf("用户详情: %s (等级 %d)\n", userInfo.Uname, userInfo.Level)

}

### 视频上传示例

```go
package main

import (
    "log"
    "strings"
    
    "github.com/difyz9/bilibili-go-sdk/bilibili"
)

func main() {
    // 首先需要登录获取 loginInfo
    // ... (登录代码省略)
    
    client := bilibili.NewClient()
    // 创建上传客户端
    uploader := bilibili.NewUploadClient(loginInfo)
    cookies := loginInfo.GetCookieString()
    
    // 上传视频文件
    video, err := uploader.UploadVideo("/path/to/your/video.mp4")
    if err != nil {
        log.Fatal(err)
    }
    
    // 上传封面
    coverURL, err := uploader.UploadCover("/path/to/cover.jpg")
    if err != nil {
        log.Fatal(err)
    }

    // 预测分区
    tid := 122
    humanType2 := 0
    predictions, err := uploader.PredictArchiveTypes(&bilibili.ArchiveTypePredictRequest{
        Filename: video.Filename,
        Title:    "我的视频标题",
    })
    if err == nil && len(predictions) > 0 {
        tid = predictions[0].ID
        if predictions[0].HumanType != nil {
            humanType2 = predictions[0].HumanType.ID
        }
    }

    // 推荐标签
    desc := "视频描述内容"
    tagNames := []string{"标签1", "标签2", "标签3"}
    tags, err := client.RecommendTags(&bilibili.TagRecommendRequest{
        SubtypeID:   tid,
        Title:       "我的视频标题",
        Filename:    video.Filename,
        Description: desc,
        CoverURL:    coverURL,
    }, cookies)
    if err == nil && len(tags) > 0 {
        tagNames = tagNames[:0]
        for _, tag := range tags {
            name := strings.TrimSpace(tag.Name)
            if name == "" {
                name = strings.TrimSpace(tag.Tag)
            }
            if name != "" {
                tagNames = append(tagNames, name)
            }
            if len(tagNames) >= 5 {
                break
            }
        }
    }
    
    // 构建 Web 投稿信息
    studio := &bilibili.Studio{
        Title:        "我的视频标题",
        Desc:         desc,
        Tid:          tid,
        HumanType2:   humanType2,
        Cover:        coverURL,
        Tag:          bilibili.FormatTags(tagNames),
        Copyright:    1,
        DescFormatId: 9999,
        Recreate:     -1,
        WebOS:        3,
        Videos:       []bilibili.Video{*video},
    }
    
    // 提交 Web 投稿
    result, err := uploader.SubmitVideo(studio)
    if err != nil {
        log.Fatal(err)
    }
    
    log.Printf("投稿成功! 结果: %+v", result)
}

API 文档

客户端 (Client)

创建客户端

client := bilibili.NewClient()

QR 码登录

// 获取 QR 码
qrResp, err := client.GetQRCode()

// 轮询登录状态
loginInfo, err := client.PollQRCode(authCode)

用户信息

// 获取详细用户信息 (推荐)
myInfo, err := client.GetMyInfo(cookies)

// 获取指定用户基本信息（用户空间详情接口）
userInfo, err := client.GetUserBasicInfo(2, cookies)

// 带重试机制的获取用户信息
myInfo, err := client.GetMyInfoWithRetry(cookies, 3)

评论操作

// 发表评论
reply, err := client.AddComment(&bilibili.CommentAddRequest{
    Type:    1,
    OID:     243322853,
    Message: "测试评论",
}, cookies)

// 点赞评论
err = client.LikeComment(&bilibili.CommentActionRequest{
    Type:   1,
    OID:    243322853,
    RPID:   reply.RPID,
    Action: 1,
}, cookies)

可运行示例：

BILIBILI_COOKIES='SESSDATA=xxx; bili_jct=xxx' go run examples/comment/main.go add 1 243322853 '测试评论'

分区信息

// 获取内置完整视频分区树（无需登录）
zones := bilibili.GetVideoZones()

// 按 tid 获取当前推荐分区（若 tid 存在重定向/历史别名，会优先返回有效分区）
zone, ok := bilibili.GetVideoZoneByTID(265)

// 获取投稿分区列表
archiveData, err := client.GetArchivePre(cookies)

投稿审核状态

status, err := client.GetVideoReviewStatus("BV1xx411c7mD", cookies)
if err != nil {
    log.Fatal(err)
}

fmt.Printf("是否通过: %v\n", status.Passed)
fmt.Printf("当前状态: %s\n", status.StateDesc)
if status.RejectReason != "" {
    fmt.Printf("驳回原因: %s\n", status.RejectReason)
}

status, err = client.WaitForVideoReviewPassed("BV1xx411c7mD", cookies, 15*time.Second, 30*time.Minute)
if err != nil {
    log.Printf("等待审核结束: %v\n", err)
}

fmt.Printf("最终状态: %s\n", status.StateDesc)

上传客户端 (UploadClient)

创建上传客户端

uploader := bilibili.NewUploadClient(loginInfo)

🚀 并发视频上传（推荐）

// 从URL并发上传视频（速度提升2-3倍）
video, err := uploader.UploadVideoFromURLConcurrent(
    "https://your-cos.com/video.mp4",  // 视频URL
    "video.mp4",                         // 文件名
    305333744,                           // 文件大小（字节）
    3,                                    // 并发数（推荐3，0=默认）
)

// 特点：
// - 3个goroutine并发上传不同分块
// - 自动选择最优上传节点
// - 实时显示速度和ETA
// - 300MB视频：180秒 → 70秒（2.6倍提升）

详细文档：

• 并发上传详细指南
• 快速开始
• 完整示例

视频上传

// 从本地文件上传
video, err := uploader.UploadVideo("/path/to/video.mp4")

// 从 URL 上传
video, err := uploader.UploadVideoFromURL("https://example.com/video.mp4", "video.mp4", fileSize)

封面上传

coverURL, err := uploader.UploadCover("/path/to/cover.jpg")

视频投稿

// 1. 上传视频后会自动拿到 filename 和 cid
studio := &bilibili.Studio{
    Title:        "视频标题",
    Desc:         "视频描述",
    Tid:          174,
    Cover:        coverURL,
    Tag:          "标签1,标签2",
    Copyright:    1,
    DescFormatId: 9999,
    Recreate:     -1,
    WebOS:        3,
    Videos:       []bilibili.Video{*video},
}

result, err := uploader.SubmitVideo(studio)

Web 投稿辅助接口

// 预测稿件分区
predictions, err := uploader.PredictArchiveTypes(&bilibili.ArchiveTypePredictRequest{
    Filename: video.Filename,
    Title:    "视频标题",
})

// 获取推荐标签
tags, err := client.RecommendTags(&bilibili.TagRecommendRequest{
    SubtypeID:   predictions[0].ID,
    Title:       "视频标题",
    Filename:    video.Filename,
    Description: "视频描述",
    CoverURL:    coverURL,
}, cookies)

// 获取新分区列表 / 模板 / 话题
humanTypes, err := uploader.GetHumanTypeList()
templates, err := uploader.GetUploadTemplates()
topics, err := uploader.QueryTopics(&bilibili.TopicQueryRequest{PN: 0, PS: 20})

字幕上传

client := bilibili.NewClient()
uploader := bilibili.NewSubtitleUploader(client, loginInfo)

// SDK 会自动把常见别名标准化为 B 站接受的语言码。
err := uploader.UploadSubtitle("BV1xx411c7mD", "/path/to/video.zh.srt", "zh")
if err != nil {
    log.Fatal(err)
}

// 也可以显式使用 SDK 常量。
err = uploader.UploadSubtitle("BV1xx411c7mD", "/path/to/video.en.srt", bilibili.SubtitleLangEN)

命令行示例：

# 先登录并保存会话
go run ./examples/login/main.go

# 查看语言值会被标准化成什么
go run ./examples/subtitle/main.go inspect zh zh-Hans zh-TW en-US

# 使用保存的登录信息上传 SRT 字幕
go run ./examples/subtitle/main.go upload BV16PoVBjE21 ./examples/subtitle/FM5-R4VPArw.zh.srt zh ./examples/login_info.json

上传说明：

• SDK 会将 SRT 转成 Bilibili draft/save 接口需要的 BCC JSON。
• language 参数最终提交为 lan 字段；简体中文建议直接传 zh。
• examples/login/main.go 会把登录态写入 examples/login_info.json，供字幕示例复用。

当前内置的语言标准化：

• zh / zh-CN / zh-Hans / cmn-Hans -> zh
• zh-TW / zh-Hant / cmn-Hant -> zh-TW
• en -> en
• en-US -> en-US

数据结构

LoginInfo - 登录信息

type LoginInfo struct {
    CookieInfo map[string]interface{} `json:"cookie_info"`
    SSO        []string               `json:"sso"`
    TokenInfo  TokenInfo              `json:"token_info"`
    Platform   string                 `json:"platform"`
}

UserInfo - 用户信息

type MyInfoResponse struct {
    Mid       int64  `json:"mid"`
    Uname     string `json:"uname"`
    Sign      string `json:"sign"`
    Face      string `json:"face"`
    Level     int    `json:"level"`
    Coins     int    `json:"coins"`
    Fans      int    `json:"fans"`
    // ... 更多字段
}

Studio - 投稿信息

type Studio struct {
    Title            string       `json:"title"`
    Desc             string       `json:"desc,omitempty"`
    Tid              int          `json:"tid"`
    HumanType2       int          `json:"human_type2,omitempty"`
    Cover            string       `json:"cover,omitempty"`
    Tag              string       `json:"tag"`
    Copyright        int          `json:"copyright"`
    DescFormatId     int          `json:"desc_format_id"`
    Recreate         int          `json:"recreate,omitempty"`
    WebOS            int          `json:"web_os,omitempty"`
    Videos           []Video      `json:"videos"`
    // ... 更多字段
}

配置选项

自定义 HTTP 客户端

import "net/http"

client := bilibili.NewClient()
// 访问内部 httpClient 进行自定义配置
client.SetTimeout(60 * time.Second)

设置代理

// 通过环境变量
os.Setenv("HTTP_PROXY", "http://127.0.0.1:7890")
os.Setenv("HTTPS_PROXY", "http://127.0.0.1:7890")

// 或通过自定义 Transport
transport := &http.Transport{
    Proxy: http.ProxyURL(proxyURL),
}

错误处理

SDK 提供了详细的错误信息和重试机制：

// 检查是否是限流错误
if bilibili.IsRateLimitError(err) {
    // 处理限流情况
    time.Sleep(time.Minute)
    // 重试
}

// 检查是否是网络错误
if bilibili.IsNetworkError(err) {
    // 处理网络错误
}

📚 示例代码

SDK 提供了多个完整的示例代码，位于 examples/ 目录下：

• examples/login/ - 登录示例（二维码登录）
• examples/user_stats/ - 获取用户信息和粉丝数
• examples/upload/ - 视频上传示例
• examples/complete/ - 完整 Web 投稿流程示例（登录、上传、分区预测、标签推荐、投稿）

运行示例：

# 登录示例
go run examples/login/main.go

# 获取用户信息和粉丝数
go run examples/user_stats/main.go

# 视频上传示例
go run examples/upload/main.go

# 完整流程示例
go run examples/complete/main.go login
go run examples/complete/main.go upload video.mp4 cover.jpg

更多示例和详细文档，请查看 EXAMPLES.md

注意事项

1. Cookie 管理: 登录后的 Cookie 需要妥善保存，用于后续 API 调用
2. 限流处理: B站 API 有限流机制，SDK 内置了重试逻辑
3. 文件大小: 视频文件建议不超过 4GB
4. 分区选择: 投稿时需要选择正确的分区 ID
5. 安全性: 请勿在公开代码中硬编码敏感信息

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

更新日志

v1.0.0

• 初始发布
• 支持 QR 码登录
• 支持用户信息获取
• 支持视频上传和投稿
• 支持封面上传
• 内置重试机制