首页 › API 文档 › AI 能力

番剧场景搜索

通过动漫截图识别番剧名称、集数、时间点。支持图片URL和文件上传两种方式,返回相似度、视频预览及Anilist元数据。

接口地址

GET, POST https://api.tinyaii.cn/v1/anime/scene

分类:AI 能力 · 返回格式:JSON · 鉴权:API Key(URL 参数 apikey 或请求头 Authorization: Bearer)

请求参数

参数名类型必填说明
urlstring否动漫截图的图片URL(需可公开访问)。GET方式query参数,或POST JSON body均可。与image二选一
imagefile否multipart/form-data 上传的图片文件(字段名 image 或 file,支持 jpg/png/webp,最大10MB)。仅POST可用,与url二选一
cut_bordersboolean否是否裁剪图片黑边后比对,对带信箱黑边的截图可提升识别率。可选值:true / false,默认 false。GET与POST均可用

返回字段

字段名类型说明
countinteger匹配结果数量(最多10条)
resultsarray匹配结果列表,按相似度降序
results[].titlestring番剧标题(优先中文>日文>罗马音>英文)
results[].anilist_idintegerAnilist动画数据库ID
results[].anilist_urlstringAnilist详情页URL
results[].episodeinteger集数(电影/OVA可能为0)
results[].fromstring匹配片段起始时间(格式 hh:mm:ss)
results[].tostring匹配片段结束时间(格式 hh:mm:ss)
results[].atstring当前帧所在时间(格式 hh:mm:ss)
results[].similaritynumber相似度百分比(0~100,建议>80为高置信度)
results[].videostring视频预览片段直链(约3-4秒小视频)
results[].thumbnailstring缩略图直链
results[].coverstring番剧封面图URL
results[].is_adultboolean是否R18内容
results[].formatstring媒体格式:TV/ONA/OVA/MOVIE等
results[].episodesinteger总集数
results[].durationstring单集时长(格式 hh:mm:ss)
results[].genresarray流派标签列表(英文,如 Action/Comedy/Fantasy)
results[].studiosarray制作工作室列表,含 name(工作室名) 和 is_main(是否主工作室)

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "count": 10,
    "results": [
      {
        "title": "Cardfight!! Vanguard (2018)",
        "anilist_id": 101594,
        "anilist_url": "https://anilist.co/anime/101594",
        "episode": 29,
        "from": "00:13:15",
        "to": "00:13:19",
        "at": "00:13:15",
        "similarity": 49.23,
        "video": "https://api.trace.moe/video/xxx",
        "thumbnail": "https://api.trace.moe/image/xxx",
        "cover": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/nx101594-xxx.jpg",
        "is_adult": false,
        "format": "TV",
        "episodes": 52,
        "duration": "00:23:59",
        "genres": [
          "Action",
          "Adventure",
          "Fantasy"
        ],
        "studios": [
          {
            "name": "OLM",
            "is_main": true
          }
        ]
      }
    ]
  }
}

调用示例

curl "https://api.tinyaii.cn/v1/anime/scene?apikey=YOUR_KEY&url=&image=&cut_borders="

把 YOUR_KEY 换成你在 用户中心 获取的 API Key,在浏览器打开同样地址也能直接看到结果。

相关接口(AI 能力)

本站收录 353 个可免费调用的 API 接口,查看完整开发文档 或 注册获取 API Key。