Vioxt Systems"Oook!"

Vioxt APIs

本页面上的某些内容为大语言模型(LLM)生成的. 如有错漏, 在此致歉.
若有不妥之处, 请电邮webmaster@vioxt.eu.orgfunctionsir@outlook.com.

一般建议, 请到GitHub Repo发Issue, 若有安全问题, 请不要直接发Issue/PR.
报告安全问题, 请电邮webmaster@vioxt.eu.orgfunctionsir@outlook.com.

您可以使用Ctrl+F快捷键或以其他方式, 使用浏览器的页面内搜索来查找您想要寻找的内容.

我们提供一些API服务.

我们的API后端代码是开源的!

🏗️访问 GitHub Repo


写在前面

一切请求的URL都是以apis.vioxt.eu.org开头.
例子: https://apis.vioxt.eu.org/bili-video-basic?bvid=BV1QDkxBaEVk&pretty=1


Fortune

描述:
该API用于返回一条随机的 "fortune" 语录.
输出由Arch Linux的extra/fortune-mod包提供. 不包含冒犯性语录.

请求方法:

GET /fortune

请求参数:
无参数.

返回示例:

Oook!

说明:

  1. 返回内容为纯文本 (Content-Type: text/plain).

错误码:

错误码 描述
500 内部服务器错误 (如 fortune 程序不可用)

BILI-VIDEO-BASIC B站视频基础信息 API

描述:
该API用于获取BiliBili视频的基础信息, 包括标题、封面、UP主信息、统计数据以及分P信息.

请求方法:

GET /bili-video-basic?aid={aid}&bvid={bvid}&pretty={true|false}

请求参数:

参数名 类型 必填 描述
aid uint64 视频的AV号 (数值ID), 与bvid二选一
bvid string 视频的BV号, 与aid二选一
pretty bool/string 是否返回格式化JSON, 支持 "true"/"1" 或 "false"/"0"

返回示例:

{
  "code": 200,
  "message": "ok",
  "data": {
    "bvid": "BV1xx411c7mD",
    "aid": 123456789,
    "cover": "https://i0.hdslb.com/...",
    "title": "示例视频标题",
    "publish_at": "2026-05-22T12:00:00Z",
    "desc": "视频简介",
    "up": {
      "uid": 987654321,
      "nickname": "示例UP主",
      "avatar": "https://i0.hdslb.com/..."
    },
    "stats": {
      "view": 10000,
      "danmaku": 500,
      "reply": 200,
      "favorite": 300,
      "coin": 150,
      "share": 80,
      "like": 600
    },
    "parts": [
      {
        "cid": 114514,
        "part_number": 1,
        "part_title": "第一P",
        "duration_s": 600,
        "danmaku_xml": "https://api.bilibili.com/x/v1/dm/list.so?oid=114514"
      }
    ]
  }
}

说明:

  1. 请求必须提供 aid 或 bvid 参数之一, 若同时提供, 则 bvid 优先.
  2. pretty 参数控制返回 JSON 是否缩进美化, 不保证美化方式不变.
  3. 返回的 publish_at 字段为 UTC 时间戳转换后的 RFC3339 格式.
  4. 每个分 P (parts) 包含弹幕 XML 地址 (danmaku_xml), 由 CID 拼接生成.
  5. 服务端会随机选择一个 User-Agent 发送给 BiliBili API.

错误码:

错误码 描述
400 参数错误 (如未提供aid或bvid, 或pretty值非法)
403 视频不可用 (如被下架)
404 视频不存在
408 请求上游超时
502 上游返回不可接受的响应
500 内部服务器错误

PASTEBINS-PROXY Pastebin 代理

描述:
该API用于从多个Pastebin服务拉取内容, 并根据调用者指定的Content-Type和b64参数返回不同格式的响应. 支持文本、JSON、XML、HTML以及常见图片格式.

注意: 由该API获取的内容, 均是用户在其他站点上产生的, 我们不对上游的内容负责, 也不提供任何相关的担保.

关于滥用情况: 请先尝试联系Pastebin服务运营方. 我们只是一个中继, 该API没有任何地方可供用户上传内容.
若Pastebin服务运营方不做回应, 才考虑电邮webmaster@vioxt.eu.orgfunctionsir@outlook.com.

请求方法:

GET /pp/{Pastebin}/{ContentType}/{PasteID}?b64={参数}

路径参数:

参数名 类型 必填 描述
Pastebin string 支持的Pastebin服务: `paste.debian.net`, `pastebin.com`, `pastebox.io`
ContentType string 返回内容类型: `html`, `plain`, `json`, `xml`, `svg`, `png`, `jpeg`, `gif`, `apng`, `avif`
PasteID string 粘贴的唯一ID, 仅允许字母和数字

查询参数:

参数名 类型 必填 描述
b64 string 控制是否将内容视为Base64并解码.
支持值: `"1"/"true"` (强制二进制), `"0"/"false"` (强制文本),
`"inv"/"-2"` (反转默认值), `"auto"/"-1"` 或空值 (自动)

返回示例 (plain):

Hello, this is a paste content.

返回示例 (json):

{
  "key": "value"
}

返回示例 (图片, b64解码后):
(返回原始二进制图片数据, Content-Type为对应图片类型)

说明:

  1. 当ContentType为`html`时, 响应头会附加 `Content-Security-Policy: script-src 'none'`, 以避免滥用.
  2. PasteID会进行合法性校验, 非法ID返回错误.
  3. 最大支持32MiB的粘贴内容 (即使上游Pastebin的限制可能大于该值).
  4. 如果b64参数启用, 服务端会尝试对内容进行Base64解码并返回二进制.

错误码:

错误码 描述
400 参数错误 (如ContentType非法, PasteID非法, b64参数非法)
415 非标准Base64内容, 无法解码
503 Pastebin服务不支持
502 上游返回错误状态码
500 内部服务器错误

waifu2x 图像超分辨率与降噪 API

描述:
使用基于 CNN (卷积神经网络) 的 waifu2x 进行图像超分辨率和降噪.

请求方法:

POST /waifu2x/{model}/{scale}/{noise}/{format}

请求参数:

  1. model: 模型选择, 可选值:
    1. cunet (CUNet 模型, 支持透明图预处理)
    2. upconv-anime (UpConv7 Anime 模型)
    3. upconv-photo (UpConv7 Photo 模型)
  2. scale: 放大倍数, 可选值: 1, 2, 4, 8
  3. noise: 降噪等级, 可选值: -1 (无降噪), 0, 1, 2, 3
  4. format: 输出格式, 可选值: png, jpg, webp
  5. 请求体: 原始图像数据 (最大 8 MiB, 支持 png, jpeg, webp)

返回示例:
成功时返回处理后的图像二进制数据, MIME 类型与 format 一致.
响应头包含:

  1. X-Input-Pre-Processed: true/false (指示输入是否经过透明图预处理)

说明:

  1. 输入图像最大边长不得超过 8000 像素.
  2. cunet 模型会自动移除透明通道, 背景填充为白色.
  3. 注意: CloudFlare可能会将响应头的名称"X-Input-Pre-Processed"转换为全小写.

错误码:

错误码 描述
400 请求参数错误 (如模型/格式非法, scale 或 noise 不合法)
413 请求体过大或图像尺寸超限
500 内部服务器错误 (如 waifu2x 程序不可用, 文件操作失败)
DokuWiki GNU Free Documentation License 1.3