Open API

Torrent match

POST /api/animes/torrent-match — preserve official bracketed subtitles, romaji and English aliases, and distinguish seasons from episodes. Conflicting titles require manual confirmation. Numeric title terms are not corrected or ignored; relaxed matching may ignore at most one ordinary word and cannot authorize auto on its own. When matching cannot complete, the response is 200 with decision.kind=unavailable, reason=search_unavailable, and no candidates; retry later or choose the anime manually.

POST
/api/animes/torrent-match

Request Body

application/json
  1. body
rawTitle*string
Length1 <= length <= 1000
torrentName?string
Length1 <= length <= 1000
infoHashHex?string

40 位十六进制 v1 infohash;提供后返回与该种子绑定的匹配令牌。

Match^[0-9a-f]{40}$
publishedAt?integer
Range0 <= value <= 9007199254740991
groupId?string

可选组织 ID;需要同源登录会话及该组成员身份,API Key 不替代会话。

Length1 <= length <= 200
limit?integer
Range1 <= value <= 50
Default10
diagnostics?false

公开接口只允许 false;true 返回 403。

Defaultfalse
Value infalse

Response Body

匹配决定

application/json
  1. response
version*3
Value in3
content*
identityKey*string|null
structure*
decision*
groupHistory*|null
candidates*array<>
search*
diagnostics*null

公开接口不返回诊断数据。

decisionToken*string|null
decisionTokenExpiresAt*|

匹配令牌过期时间,Unix 毫秒;未提供 infoHashHex 时为 null。

Example Request
curl -X POST 'https://anibt.net/api/animes/torrent-match' \  -H 'Content-Type: application/json' \  -d '{  "rawTitle": "string"}'
{  "version": 3,  "content": {    "kind": "anime_episode",    "confidence": "high",    "reasonCodes": [      "content.anime_episode"    ]  },  "identityKey": "sousou no frieren|s-|c-|p-|q-|f-",  "structure": {    "season": null,    "cour": null,    "part": null,    "sequence": null,    "format": null  },  "decision": {    "kind": "auto",    "reason": "top_ranked_candidate",    "animeId": "nh7a01k9tn1gew971x43xw4hgh7ys5aq",    "bgmId": 400602,    "confidence": "high",    "vetoes": []  },  "groupHistory": null,  "candidates": [    {      "anime": {        "_id": "nh7a01k9tn1gew971x43xw4hgh7ys5aq",        "_creationTime": 1767746048514,        "bgmId": 400602,        "title": {          "chinese": "葬送的芙莉莲",          "native": "葬送のフリーレン"        },        "titleRomaji": "葬送的芙莉莲",        "coverImage": {          "extraLarge": "https://r2.anibt.net/anime_covers/nh7a01k9tn1gew971x43xw4hgh7ys5aq/7394961b8393ee7b02c54c53725d8fb6718c702d4c028f18db86dad8e8c080dd.jpg",          "large": "https://r2.anibt.net/anime_covers/nh7a01k9tn1gew971x43xw4hgh7ys5aq/7394961b8393ee7b02c54c53725d8fb6718c702d4c028f18db86dad8e8c080dd.jpg"        },        "coverImageWebp": {          "sourceKey": "anime_covers/nh7a01k9tn1gew971x43xw4hgh7ys5aq/7394961b8393ee7b02c54c53725d8fb6718c702d4c028f18db86dad8e8c080dd.jpg",          "version": 4,          "generatedAt": 1781195406072,          "variants": [            {              "width": 240,              "key": "anime_covers/nh7a01k9tn1gew971x43xw4hgh7ys5aq/7394961b8393ee7b02c54c53725d8fb6718c702d4c028f18db86dad8e8c080dd/v4/w240.webp",              "url": "https://r2.anibt.net/anime_covers/nh7a01k9tn1gew971x43xw4hgh7ys5aq/7394961b8393ee7b02c54c53725d8fb6718c702d4c028f18db86dad8e8c080dd/v4/w240.webp"            },            {              "width": 360,              "key": "anime_covers/nh7a01k9tn1gew971x43xw4hgh7ys5aq/7394961b8393ee7b02c54c53725d8fb6718c702d4c028f18db86dad8e8c080dd/v4/w360.webp",              "url": "https://r2.anibt.net/anime_covers/nh7a01k9tn1gew971x43xw4hgh7ys5aq/7394961b8393ee7b02c54c53725d8fb6718c702d4c028f18db86dad8e8c080dd/v4/w360.webp"            }          ]        },        "officialSite": "https://frieren-anime.jp/",        "format": "TV",        "status": "FINISHED",        "season": "SUMMER",        "seasonYear": 2023,        "episodes": 36,        "averageScore": 85,        "genres": [          "治愈",          "公路片"        ]      },      "animeId": "nh7a01k9tn1gew971x43xw4hgh7ys5aq",      "bgmId": 400602,      "matchScore": 100,      "textMatch": 0,      "matchedHypothesisIds": [        "release_title_hyp_3"      ],      "matchedInputs": [        "release_title"      ],      "retrieval": [        "exact"      ],      "evidenceSummary": {        "source": "anidb",        "kind": "primary",        "rawAlias": "Sousou no Frieren",        "strictKey": "sousou no frieren",        "matchClass": "exact",        "evidenceStrength": "exact_alias",        "retrievalProvenance": "exact_filter",        "sourceFamily": "anidb",        "matchedQueryVariant": "Sousou no Frieren"      }    },    {      "anime": {        "_id": "nh7azzmt97g74hxhj7s31nj91s7ysvza",        "_creationTime": 1767746084120,        "bgmId": 515759,        "title": {          "chinese": "葬送的芙莉莲 第二季",          "native": "葬送のフリーレン 第2期"        },        "titleRomaji": "葬送的芙莉莲 第二季",        "coverImage": {          "extraLarge": "https://r2.anibt.net/anime_covers/nh7azzmt97g74hxhj7s31nj91s7ysvza/22f07b8002179f98592696e55ac9782a361d2cc3b8a5b4005a05ab136e7d4530.jpg",          "large": "https://r2.anibt.net/anime_covers/nh7azzmt97g74hxhj7s31nj91s7ysvza/22f07b8002179f98592696e55ac9782a361d2cc3b8a5b4005a05ab136e7d4530.jpg",          "color": "#5dc9f1"        },        "coverImageWebp": {          "sourceKey": "anime_covers/nh7azzmt97g74hxhj7s31nj91s7ysvza/22f07b8002179f98592696e55ac9782a361d2cc3b8a5b4005a05ab136e7d4530.jpg",          "version": 4,          "generatedAt": 1781190254074,          "variants": [            {              "width": 240,              "key": "anime_covers/nh7azzmt97g74hxhj7s31nj91s7ysvza/22f07b8002179f98592696e55ac9782a361d2cc3b8a5b4005a05ab136e7d4530/v4/w240.webp",              "url": "https://r2.anibt.net/anime_covers/nh7azzmt97g74hxhj7s31nj91s7ysvza/22f07b8002179f98592696e55ac9782a361d2cc3b8a5b4005a05ab136e7d4530/v4/w240.webp"            },            {              "width": 360,              "key": "anime_covers/nh7azzmt97g74hxhj7s31nj91s7ysvza/22f07b8002179f98592696e55ac9782a361d2cc3b8a5b4005a05ab136e7d4530/v4/w360.webp",              "url": "https://r2.anibt.net/anime_covers/nh7azzmt97g74hxhj7s31nj91s7ysvza/22f07b8002179f98592696e55ac9782a361d2cc3b8a5b4005a05ab136e7d4530/v4/w360.webp"            }          ]        },        "officialSite": "https://frieren-anime.jp/",        "format": "TV",        "status": "FINISHED",        "season": "WINTER",        "seasonYear": 2026,        "episodes": 10,        "averageScore": 75,        "genres": [          "奇幻",          "MADHouse"        ]      },      "animeId": "nh7azzmt97g74hxhj7s31nj91s7ysvza",      "bgmId": 515759,      "matchScore": 80,      "textMatch": 0,      "matchedHypothesisIds": [        "release_title_hyp_3"      ],      "matchedInputs": [        "release_title"      ],      "retrieval": [        "exact"      ],      "evidenceSummary": {        "source": "bgm_tv",        "kind": "alternate",        "rawAlias": "Sousou no Frieren 2nd Season",        "strictKey": "sousou no frieren 2nd season",        "matchClass": "base",        "evidenceStrength": "exact_alias",        "retrievalProvenance": "exact_filter",        "sourceFamily": "bangumi_tv",        "seasonNumber": 2,        "matchedQueryVariant": "Sousou no Frieren"      }    }  ],  "search": {    "branchCount": 2,    "exactOverflow": false,    "recallOverflow": false,    "candidateOverflow": false,    "searchCutoff": false,    "exactVerificationFailed": false,    "versionMismatch": false,    "generationMismatch": false,    "projectionMismatch": false,    "candidateSetComplete": true,    "strictRecallUsed": false,    "fuzzyRecallUsed": false,    "generation": "postgres-search-v1-recall-v1"  },  "diagnostics": null,  "decisionToken": null,  "decisionTokenExpiresAt": null}