Get a Free Bilibili Image Host in 1 Minute

⚠️ Disclaimer: This article is for technical learning and research only. Do not use it for any illegal purpose or abusive behavior. You must comply with applicable laws/regulations and the platform’s terms of service. Any consequences caused by improper use are solely your responsibility.

Technical principle

At its core, this is a technique that leverages characteristics of Bilibili’s image upload interface. By calling Bilibili’s public upload API, you can store image assets on Bilibili’s servers and take advantage of its CDN to distribute content globally, resulting in fast and stable hotlinkable image URLs.

How to call the API

API endpoint

1
POST https://api.bilibili.com/x/upload/web/image

Request example

curl -X POST "https://api.bilibili.com/x/upload/web/image" \
  -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" \
  -b "SESSDATA=your_SESSDATA;bili_jct=your_BILI_JCT" \
  -F "bucket=live" \
  -F "csrf=your_BILI_JCT" \
  -F "[email protected];filename=image.png"

How to get SESSDATA and BILI_JCT

1. Open the Bilibili homepage and make sure you are logged in.
2. Press F12 to open your browser devtools.
3. Switch to the Application tab.
4. In the left sidebar, go to Storage → Cookies and select the *.bilibili.com domain.
5. Find SESSDATA and BILI_JCT in the cookie list. The Value field is what you need.

Parameter notes

Response format

1
{
2
  "code": 0,
3
  "message": "success",
4
  "data": {
5
    "image_url": "http://i0.hdslb.com/bfs/album/104c4f1ae6b66d78a5952a191281ec7883dc5c5c.jpg",
6
    "image_width": 818,
7
    "image_height": 1000
8
  }
9
}

Response fields

Image style parameters explained

Bilibili’s image host supports real-time processing via URL parameters, including resizing, cropping, format conversion, and quality compression.

Common style examples

Parameter grammar

Pattern:

1
(image_original_url)@(\d+[whsepqoc]_?)*(\.(webp|gif|png|jpg|jpeg))?$

Parameter reference

Format suffix

Supported formats:

• webp - recommended; smallest size
• png - lossless
• jpeg / jpg - lossy compression
• gif - animated format
• If omitted, the original format is preserved

Notes

1. Parameters are case-insensitive
2. If the same parameter appears multiple times, the last one wins
3. The computed width×height must not exceed the original image size, otherwise the width/height parameters will not take effect
4. WebP is recommended for the best compression ratio

Related tools/projects

bilibili-img-uploader

This is a mature browser extension that has been running stably for 6 years, providing an easy way to upload images to Bilibili and get shareable links.

Project info

• Repo: https://github.com/xlzy520/bilibili-img-uploader
• License: MIT License
• Project status (at the time of writing): ⭐ 406+ Stars | 39+ Forks
• Tech stack: Vue 3 + TypeScript + Vite

Supported platforms

Key features

Automatic cookie reading - no need to manually configure SESSDATA and bili_jct
Multiple output formats - supports WebP, JPEG, PNG, etc.
Live preview - preview before uploading
Batch upload - upload multiple images at once
Quick copy - one-click copy for image links
Short link generation - converts to Bilibili short links

Web version

If you do not want to install a browser extension, there is also a web version:

• URL: https://www.xiaojuzi.fun/bili-short-url/upload.html
• Note: you must manually provide SESSDATA and bili_jct

Local development

# Install deps
pnpm install

# Dev mode (HMR)
pnpm run dev

# Production build
pnpm run build

After building, enable Developer Mode on chrome://extensions/ and load the extension folder.

⚠️ Important notes

API stability warning

According to the project’s issue history, Bilibili adjusted the image upload interface in December 2023, which shortened the validity period of the returned image links to 45 minutes. Although the project has since updated to use the new interface, you should still keep in mind:

1. Availability is not guaranteed - Bilibili may change or close the interface at any time
2. Permanence is not guaranteed - keep local backups for important images
3. Do not abuse it - large-volume uploads can lead to account restrictions

Cookie security

• SESSDATA and bili_jct are sensitive; keep them safe
• Do not enter cookies on public computers or untrusted websites
• Change your Bilibili password regularly to protect your account

Hotlink protection workarounds

Bilibili’s image host has hotlink protection. If you embed images directly on other sites, they may fail to load. Here are two approaches:

Option 1: Disable referrer site-wide

Add this in your HTML <head>:

1
<meta name="referrer" content="no-referrer" />

Then all requests from your site will not carry the referrer header.

Option 2: Handle per-link

For a single link, you can use rel="noreferrer":

1
<a href="IMAGE_URL" rel="noreferrer" target="_blank">
2
  <img src="IMAGE_URL" alt="Description" />
3
</a>

Note: window.open will include referrer by default, so you need special handling.

References

Most of the technical info in this post comes from:

• xlzy520/bilibili-img-uploader - open-source browser extension
• SocialSisterYi/bilibili-API-collect - Bilibili API documentation collection

Acknowledgements

Thanks to @xlzy520 and all contributors for maintaining and updating this project over the years. If you find it useful, consider giving it a ⭐.

One more reminder: This document is only for technical research and learning. Please follow platform rules and use these techniques legally and responsibly. Any consequences caused by abuse are solely your responsibility.