AniBT Wiki
公开 API

接口参考

AniBT JSON 与 RSS 接口的方法、路径、参数和响应。

生产 base URL：https://anibt.net。路径与查询参数是公开契约，只做扩展、不做不兼容变更。内部主键（organizationId、_id）不属于公开契约，第三方用 slug。

只使用本文列出的主站路径。写入、删除、/me 的 API Key 不要放进客户端或仓库。

限流、缓存、304 细节见 限流、缓存。

鉴权

类型用法
公开读取无需鉴权
字幕组 API KeyAuthorization: Bearer <KEY>，或 X-API-Key。Bearer 优先
Key scopereleases:publish、releases:delete，至少选一个
个人订阅 RSS账户后台生成的订阅链接

错误

写入接口统一 JSON：

错误
{
  "ok": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "…",
    "reason": "RATE_LIMITED",
    "retryable": true,
    "retryAfterMs": 2000,
    "requestId": "req-…"
  }
}
HTTP含义
400参数或 JSON 有误
401认证未通过
403无权限或缺少 scope
404资源不存在，或无权访问时与不存在相同
413请求体过大
422校验未通过
429按 Retry-After 退避
503服务暂时不可用或部署中，按 Retry-After 重试

公开读取超限同样返回 429；Cloudflare 边缘限流可能是 HTML 429。

JSON

字幕组目录

GET /api/subtitle-groups

公开

可见字幕组列表。启动时拉一次，缓存 name → slug。

200
{
  "ok": true,
  "data": [
    {
      "slug": "kirara-fantasia",
      "name": "Kirara Fantasia",
      "organizationId": "org_HCFDS3FmwXnP",
      "status": "ACTIVE",
      "totalReleases": 469,
      "totalAnimes": 84,
      "createdAt": 1775269444251
    }
  ]
}

字段

类型

字幕组自身信息

GET /api/subtitle-groups/me

鉴权

当前 Key 所属字幕组、scope 与统计。

200
{
  "ok": true,
  "data": {
    "_id": "…",
    "name": "My Group",
    "slug": "my-group",
    "description": "…",
    "website": "https://…",
    "stats": { "totalReleases": 42, "totalAnimes": 10, "memberCount": 5 },
    "status": "active",
    "createdAt": 1700000000000,
    "apiKeyId": "sgak_xxxxxxxx",
    "apiKeySuffix": "5c5d6fcd",
    "scopes": ["releases:publish", "releases:delete"]
  }
}

仅 status=active 可发布。apiKeySuffix 不能用于鉴权。

Bangumi 搜索

GET /api/bgm/search

公开

把番剧名映射为 bgmId。站内未收录的作品搜不到。

字段

类型

200
{
  "ok": true,
  "data": [
    {
      "bgmId": 400602,
      "name": "葬送のフリーレン",
      "nameCn": "葬送的芙莉莲",
      "date": null,
      "image": "https://…",
      "rating": 8.5,
      "totalEpisodes": 28,
      "url": "https://bgm.tv/subject/400602"
    }
  ]
}

不保证第一条就是目标作品。结果按相关度排序。

季度番剧

GET /api/seasons/anime

公开

当季已上架番剧。bgmId 优先于 season，且不能与 query 同时使用。

字段

类型

200
{
  "ok": true,
  "ts": 1776841966624,
  "data": {
    "currentSeason": "2026春",
    "requestedSeason": "2026春",
    "availableSeasons": ["2024春", "2026春"],
    "scheduleSummary": { "scheduled": 97, "weekdayOnly": 0, "missingSource": 9 },
    "byWeekday": [
      {
        "weekday": 1,
        "weekdayLabel": "周一",
        "animes": [
          {
            "bgmId": 543360,
            "title": { "primary": "…", "chinese": "…", "romaji": "…", "english": "…", "japanese": "…" },
            "format": "TV",
            "kind": "TV",
            "rating": 73,
            "airingAt": 1764259200,
            "scheduleStatus": "scheduled",
            "rssReleaseCount": 11,
            "hasRelease": true
          }
        ]
      }
    ],
    "total": 106
  }
}

weekday：0=周日 … 6=周六，按 Asia/Shanghai；null 为未排播。rating 为 0–100。

单番剧字幕组

GET /api/anime/groups

公开

某 bgmId 正在发布的字幕组，以及每组最近 30 条资源。

字段

类型

只有公共读模型中的 Anime 投影完整且为 live 时才返回 200。明确的 ANIME_NOT_FOUND 结果返回 404；公共投影缺失或不一致、候选资源超过 10,000 条、表示超过 2 MiB，或读取暂时不可用时返回 503 SEARCH_UNAVAILABLE， 并带 Retry-After 与 Cache-Control: no-store。成功响应的 JSON、ETag、 HEAD 和 304 保持稳定；浏览器使用 max-age=0，边缘按接口合同缓存。 magnet 可能为 null。subtitle：EMBEDDED / EXTERNAL / BUILT_IN / NONE。

200
{
  "ok": true,
  "ts": 1776841967132,
  "data": {
    "bgmId": 543360,
    "animeId": "nh73r0ernee7s0afv9s82f763983gcz7",
    "groups": [
      {
        "groupId": "org_aagmgM9i0ZyR",
        "slug": "kitauji-sub",
        "name": "北宇治字幕组",
        "status": "ACTIVE",
        "lastUpdatedAt": 1776624843260,
        "items": [
          {
            "releaseId": "rel_fItEHE7r1gR1",
            "title": "[北宇治字幕组] … [02]",
            "magnet": "magnet:?xt=urn:btih:…",
            "episodeKey": "2",
            "resolution": "1080p",
            "language": ["CHT", "JP"],
            "subtitle": "EMBEDDED",
            "publishedAt": 1776624843260
          }
        ]
      }
    ],
    "total": 4
  }
}

种子标题匹配番剧

POST /api/animes/torrent-match

公开

解析发布标题与种子内部名，返回 auto / manual 等决定。传入 groupId 时必须登录且属于该组。GET 返回 405 METHOD_NOT_ALLOWED。

字段

类型

公开路由 diagnostics=true 返回 403。请求体上限 32 KiB。不缓存。

200
{
  "version": 3,
  "decision": {
    "kind": "auto",
    "reason": "multi_branch_identity_unique",
    "animeId": "anime_example",
    "bgmId": 253046,
    "confidence": "high",
    "vetoes": []
  },
  "candidates": [],
  "search": { "candidateSetComplete": true, "generation": "match_v3_20260718_2040" },
  "diagnostics": null
}
decision.kind含义
auto可用 decision.animeId，且必须出现在 candidates
manual展示候选，不得自动绑定
none无候选
non_anime非番剧
unsupported合集等无法用单番剧表达
unavailable检索不可用，稍后重试

发布接口未带番剧 ID 时会在服务端跑同一 matcher。不要把调用方伪造的匹配结果传给发布接口。

RSS

浏览器直开返回原生 XML。搜索引擎不抓 /rss/。

番剧 RSS

GET /rss/anime.xml

公开

主入口。bgmId 与 groupSlug 至少提供一个。兼容 Mikan 的 bangumiId、subgroupid。

字段

类型

Tag 可重复或逗号分隔：?resolution=1080p&resolution=720p 与 ?resolution=1080p,720p 等价。非法 limit 返回应用 400，生产边缘可能先 403。与默认值等价的写法会 308 到规范 URL。

每个 <item>：<title>、<link>（/release/<id>）、<guid>、<pubDate>（RFC 822，+0800）、<enclosure> 磁力、<torrent> infoHash、已绑定时 <anibt:bgmId>。

字幕组短链 RSS

GET /rss/group/<slug>.xml

公开

等价 /rss/anime.xml?groupSlug=<slug>。不支持 Tag 过滤。路径必须以 .xml 结尾。未知 slug 返回 404。

支持 limit=1..100。

全站磁力 RSS

GET /rss/magnets.xml

公开

全站最近发布。anime 条目带 <anibt:bgmId>（已绑定才有）。

字段

类型

q 与 search 只能提供一个值。空、控制字符或超长返回 400。

其他类 RSS

GET /rss/other/<category>.xml

公开

不混入番剧 RSS。分类：manga / music / raw / stage / collection / movie / other。空分类仍返回有效空 channel。

字段

类型

无 <anibt:bgmId>。详情页路径：/other-release/<id>。

个人订阅 RSS

GET /rss/subscriptions.xml

鉴权

前端已保存订阅的合并 feed。使用后台生成的完整链接。响应 Cache-Control: private, no-store，无公开 ETag。

缺少 token 返回 400，凭证无效 401，已吊销 403。

写入

发布身份

GET /api/releases/publish

鉴权

不写库。不要求 releases:publish。

200
{
  "ok": true,
  "result": {
    "groupId": "org_xxxxxxxx",
    "groupName": "LoliHouse",
    "groupSlug": "lolihouse",
    "apiKeyId": "sgak_xxxxxxxx",
    "apiKeySuffix": "5c5d6fcd",
    "scopes": ["releases:publish"],
    "kind": "anime"
  }
}

发布番剧资源

POST /api/releases/publish

鉴权 · releases:publish

multipart/form-data 上传 .torrent（推荐），或 JSON 传磁力。200 表示主记录已写入，不表示 RSS / 搜索 / 页面已可见。

字段

类型

Nyaa 代发要求种子含 http://nyaa.tracker.wf:7777/announce。分类代码见 发布资源。

200
{
  "ok": true,
  "result": {
    "releaseId": "rel_xxxxxxxx",
    "animeId": "anime_xxxxxxxx",
    "matchStatus": "matched",
    "fileSize": 734003200,
    "groupId": "org_xxxxxxxx",
    "groupName": "LoliHouse",
    "groupSlug": "lolihouse",
    "apiKeyId": "sgak_xxxxxxxx",
    "apiKeySuffix": "5c5d6fcd"
  }
}
HTTP原因
401Key 无效
403缺少 releases:publish
409同版本已存在，换 version
413种子过大
422EMPTY_RELEASE_CONTENT 等校验失败
429 / 503按 Retry-After 退避

其他类发布身份

GET /api/other-releases/publish

鉴权

kind 为 other。不写库。

发布其他类资源

POST /api/other-releases/publish

鉴权 · releases:publish

不绑定 bgmId。category 与 title 必填；torrent / torrentStorageId / magnetLink / magnetBase64 至少一个。

字段

类型

200
{
  "ok": true,
  "result": {
    "releaseId": "orel_DYXiEZs5KMep",
    "groupId": "org_xxx",
    "groupName": "示例字幕组",
    "groupSlug": "example",
    "category": "manga",
    "fileSize": 734003200
  }
}

删除番剧发布

DELETE /api/releases/{releaseId}

鉴权 · releases:delete

只支持 rel_*。无 query、无请求体。最多等待约 2 秒：完成返回 200，否则 202。重复 DELETE 幂等。

releaseId：^rel_[A-Za-z0-9_-]+$，5–100 字符。普通成员只能删自己的发布；owner / admin 可删本组任意发布。无权与不存在一样返回 404。

202
{
  "ok": true,
  "result": {
    "operationId": "rdel_example",
    "releaseId": "rel_example",
    "state": "pending",
    "statusUrl": "/api/releases/rel_example/deletion",
    "acceptedAt": 1784693156387,
    "updatedAt": 1784693156387,
    "retryAfterMs": 2000
  }
}

响应头：Location、Retry-After、Cache-Control: private, no-store。

删除状态

GET /api/releases/{releaseId}/deletion

鉴权 · releases:delete

查询同一删除回执。未知、从未删除或无权一律 404。

state含义
pending按 Retry-After 继续轮询
completed站内公开面已不可见
failed停止自动重试，记录 failure.code 与 X-Request-ID

202 只表示已受理。只有 completed 才表示主记录、公开读模型、缓存和对象存储已通过删除屏障。

Tracker

制种时使用的 AniBT announce 地址。

总览

AniBT 公开 RSS 与 JSON API 入口。契约见接口参考。

本页目录

鉴权错误JSON字幕组目录字幕组自身信息Bangumi 搜索季度番剧单番剧字幕组种子标题匹配番剧RSS番剧 RSS字幕组短链 RSS全站磁力 RSS其他类 RSS个人订阅 RSS写入发布身份发布番剧资源其他类发布身份发布其他类资源删除番剧发布删除状态