上传文件
  1. base64hub
  2. 下载
  3. HTTP API
v1.0.0 · 开源 · MIT

免费 Base64 API:通过 HTTPS 编码、解码和校验

https://api.base64hub.com/v1 通过普通的 HTTPS 编码、解码和校验 Base64。无需注册,无需密钥,JSON 输入输出,并支持 CORS,在浏览器中也能调用。

免费 无需账号,无需密钥 MIT 开源许可证 零 运行时依赖 更新于 2026年11月22日

接口

方法路径作用
POST/v1/encode文本或原始字节转 Base64;标准或 URL 安全,可选填充和换行
POST/v1/decodeBase64 转文本,二进制数据转十六进制,或返回原始字节
POST/v1/validate是不是 Base64、哪种字母表、是否填充、有多少字节
GET/v1/health状态和版本
GET/v1/openapi.jsonOpenAPI 3.1 描述

请求和响应都是 JSON。encode 也接受以 application/octet-stream 发送的原始字节;用 Accept: application/octet-stream 请求时,decode 可以返回原始字节。

请求和响应示例

把一个字符串编码为不带填充的 URL 安全 Base64:

curl -s https://api.base64hub.com/v1/encode \
  -H 'Content-Type: application/json' \
  -d '{"input": "Привет", "variant": "url", "padding": false}'
{"output":"0J_RgNC40LLQtdGC","variant":"url","padding":false,"bytes_in":12,"bytes_out":16}

decode 的用法相同,字节不是文本时会告诉你:

curl -s https://api.base64hub.com/v1/decode \
  -H 'Content-Type: text/plain' -d '+/+/'
{"output":null,"utf8":false,"hex":"fbffbf","bytes_out":3}

解码器有意设计得宽松:空格和换行、data:...;base64, 前缀、缺失的填充以及两种字母表都接受。真正的错误会以 400 invalid_base64 返回,并给出有问题的字符及其位置,例如 invalid character '!' at position 4。

限制与行为

  • 认证: 无,不需要密钥或令牌。
  • 速率限制: 每个 IP 地址每 10 秒 20 个请求。超出限制时,Cloudflare 会返回状态码 429。
  • 请求体大小: 最大 1 MB。更大的请求体会得到 413 too_large。
  • 严格的输入: 未知的 JSON 字段和查询参数会以 400 invalid_body 拒绝,所以选项名拼错绝不会被悄悄忽略。
  • CORS: 每个响应都带有 Access-Control-Allow-Origin: *,预检请求会得到响应。
  • 缓存: 每个响应都是 Cache-Control: no-store。

API 概览 提供完整的错误表,以及每种内容类型的规则。

什么时候用 API 处理 Base64

Base64 的计算成本很低,每种语言都内置了它:浏览器中有 btoa,Node.js 中有 Buffer,Python 中有 base64 模块。在以下情况下,调用 Web 服务来做这件事才说得通:

  • 你在使用无代码工具、电子表格或 webhook 构建器,它们能发 HTTP 请求,却不能运行代码;
  • 你希望在每种语言中都获得同样宽松的解码和校验,而不必逐一移植;
  • 你在测试或教学,需要一个可以对照的参考答案。

处理任何敏感内容,例如令牌或私钥时,请优先使用本地工具:本站的 浏览器工具、CLI,或者 npm 和 Python 软件包都能给出完全相同的结果,数据也不会离开你的电脑。

常见问题

base64hub API 真的免费吗?

是的。不需要密钥,也不需要账号。每个 IP 地址每 10 秒 20 个请求的速率限制,保证了每个人都能用上。

API 会存储我发送的内容吗?

不会。它作为不带存储的 Cloudflare Worker 运行,也不记录请求体。即便如此,能用本地工具解决的事,就不要把机密发给任何 Web 服务;b64 CLI 离线也能得到相同的结果。

可以在浏览器中用 JavaScript 调用这个 Base64 API 吗?

可以。每个响应都带有 Access-Control-Allow-Origin: *,预检请求也会得到响应,所以 fetch() 可以从任何来源调用它。

用这个 API 最大能编码多大的文件?

请求体限制为 1 MB。更大的文件请用支持流式处理的 CLI,或者在浏览器中使用 文件转 Base64 工具。

base64hub 的更多产品