小影API 小影API

電影

電影聚合服務：提供影視的分類、列表、詳情、選集與播放地址（m3u8）能力，按「列表 → 詳情 → 播放」流程即可搭建完整影視站。

/api/movies/

服務說明

電影服務聚合影視站數據，提供分類、篩選條件、首頁推薦、列表、詳情、選集與播放地址（m3u8）等完整鏈路，按「分類 → 列表 → 詳情 → 播放地址」的順序即可搭起一個影視站，搜索接口則支持按片名關鍵詞查片。

關鍵 ID 有固定的傳遞順序：分類接口返回的 id 傳給列表接口的 type_id，列表中的 id 傳給詳情接口的 vod_id，詳情中的 sid / nid 再傳給播放接口取地址，串起來就是一條完整的播放流程。

數據類信息（片名、簡介、集數等）緩存時間較長；播放地址（m3u8）因為帶時效只做較短緩存，請勿在客戶端長期緩存播放地址。本服務需項目簽名。

響應格式

所有接口返回同一個 JSON 信封，業務數據都在 data 裡： 

{
  "code": 10000,
  "msg": "成功",
  "data": { ... }
}
  • code：業務狀態碼，10000 表示成功；其餘為各類錯誤，完整清單見「錯誤碼」頁。
  • msg：給人看的提示文案，可直接展示給終端用戶，但不要用它做邏輯判斷。
  • data：業務數據；出錯時通常為 null。各接口 data 的具體字段見該接口的「響應說明」。

判斷成功與否請看 code，不要依賴 HTTP 狀態碼。 查看完整錯誤碼

555電影

555電影（5dy4.vip） 需簽名

實時爬取源站並緩存。數據類（片名/詳情/集數）緩存較久，播放地址（m3u8）緩存較短以便及時刷新。

GET /api/movies/movie_555/categories 累計調用 0 次

分類列表

獲取可用分類（主分類 / 子分類 / 專題）。

  • 用於搭建站點導航：main 為主分類，sub 為連續劇的子分類，返回的 id 都可直接傳給「列表」接口的 type_id。
響應說明 外層統一格式
字段 類型 說明
main array 主分類列表
main[].id int 分類 ID，傳給列表接口 type_id
main[].name string 分類名稱
sub array 連續劇的子分類列表
sub[].id int 子分類 ID，同樣可傳 type_id
sub[].name string 子分類名稱
labels array 首頁專題（label）列表
labels[].key string 專題標識
labels[].name string 專題名稱
返回示例 
{
  "main": [
    {"id": 1, "name": "电影"},
    {"id": 2, "name": "连续剧"}
  ],
  "sub": [
    {"id": 13, "name": "热门连续剧"}
  ],
  "labels": [
    {"key": "netflix", "name": "Netflix 专区"}
  ]
}
GET /api/movies/movie_555/filters 累計調用 0 次

篩選條件

獲取某分類可用的篩選條件：子分類、地區、題材、語言、年份、排序。

必填：分類 ID（見「分類列表」接口），如 1=電影 2=連續劇。

  • 返回 data.sub_types（子分類，value 回傳給 type_id）與 data.groups。
  • data.groups 含地區 / 題材 / 語言 / 年份 / 排序五組，value 回傳給「列表」接口的同名參數。
  • 各分類的可用值不同（例如動漫有「日本 / 歐美」，綜藝有「真人秀 / 脫口秀」），年份還會隨站點上新自動增加，建議由本接口動態渲染篩選欄，不要在客戶端寫死。
響應說明 外層統一格式
字段 類型 說明
type_id int 分類 ID（回帶入參）
sub_types array 該分類的子分類
sub_types[].name string 子分類名稱
sub_types[].value string 值，回傳給列表接口 type_id
groups array 篩選條件分組（地區/題材/語言/年份/排序）
groups[].key string 參數名（area/genre/lang/year/order）
groups[].name string 分組名稱
groups[].options array 該組的可選值
groups[].options[].name string 選項名稱
groups[].options[].value string 選項值，回傳給同名參數
返回示例 
{
  "type_id": 1,
  "sub_types": [{"name": "动作片", "value": "6"}],
  "groups": [
    {"key": "area", "name": "地区", "options": [{"name": "大陆", "value": "大陆"}]}
  ]
}
GET /api/movies/movie_555/home 累計調用 0 次

首頁聚合

獲取首頁聚合數據：輪播圖與各推薦區塊（本周/本月最佳、各榜單等）。

  • 一次返回首頁全部推薦區塊，便於直接渲染站點首頁。
響應說明 外層統一格式
字段 類型 說明
carousel array 輪播圖
carousel[].id string 影片 ID
carousel[].name string 片名
carousel[].url string 詳情頁地址
carousel[].cover string 封面圖地址
carousel[].note string 角標/備註
carousel[].intro string 一句話簡介
blocks array 推薦區塊列表
blocks[].title string 區塊標題
blocks[].items array 區塊內影片
blocks[].items[].id string 影片 ID
blocks[].items[].name string 片名
blocks[].items[].url string 詳情頁地址
blocks[].items[].cover string 封面圖地址
blocks[].items[].note string 角標/備註
blocks[].items[].douban string 豆瓣評分
返回示例 
{
  "carousel": [
    {"id": "812640", "name": "示例影片", "url": "https://5dy4.vip/voddetail/812640.html", "cover": "https://img.example.com/812640.jpg", "note": "", "intro": ""}
  ],
  "blocks": [
    {"title": "本周最佳", "items": [
      {"id": "812640", "name": "示例影片", "url": "https://5dy4.vip/voddetail/812640.html", "cover": "https://img.example.com/812640.jpg", "note": "", "douban": "8.0"}
    ]}
  ]
}
GET /api/movies/movie_555/list 累計調用 0 次

分類列表

按分類獲取影片列表，支持分頁、排序與年份 / 地區 / 題材 / 語言組合篩選。

必填：分類 ID，1=電影 2=連續劇 3=綜藝紀錄 4=動漫 124=福利 126=擦邊短劇（子分類見「分類列表」接口的 sub）。

可選：頁碼，從 1 開始，默認 1。

可選：排序方式 time/hits/score。

可選：按年份篩選，如 2026（取值見「篩選條件」接口的 year 組）。

可選：按地區篩選，如 大陸（取值見「篩選條件」接口的 area 組）。

可選：按題材篩選，如 動作（取值見「篩選條件」接口的 genre 組）。

可選：按語言篩選，如 國語（取值見「篩選條件」接口的 lang 組）。

  • 返回 data.items（影片列表）與 data.pagination（分頁信息）。
  • 地區 / 題材 / 語言 / 年份 / 排序可任意組合，源站按交集返回；組合後沒有匹配影片時 data.items 為空數組，不會報錯。
響應說明 外層統一格式
字段 類型 說明
type_id int 分類 ID（回帶入參）
page int 當前頁碼
items array 影片列表
items[].id string 影片 ID（傳給詳情接口 vod_id）
items[].name string 片名
items[].url string 詳情頁地址
items[].cover string 封面圖地址
items[].note string 角標/備註
items[].douban string 豆瓣評分
pagination object 分頁信息
pagination.current int 當前頁碼
pagination.total int 總頁數
返回示例 
{
  "type_id": 1,
  "page": 1,
  "items": [
    {"id": "812640", "name": "示例影片", "url": "https://5dy4.vip/voddetail/812640.html", "cover": "https://img.example.com/812640.jpg", "note": "更新至10集", "douban": "8.0"}
  ],
  "pagination": {"current": 1, "total": 44}
}
GET /api/movies/movie_555/detail 累計調用 0 次

影片詳情

獲取影片詳情：簡介、導演/演員等元數據、播放源與選集列表。

必填：影片 ID（取自列表/搜索結果中的 id）。

  • 返回 data.sources（播放源），每個源含 episodes（選集），選集裡的 sid/nid 用於「播放地址」接口。
  • 影片不存在時返回 40001。
響應說明 外層統一格式
字段 類型 說明
id string 影片 ID
name string 片名
cover string 封面圖地址
intro string 劇情簡介
info object 元數據鍵值對（導演/主演/上映等）
sources array 播放源列表
sources[].sid string 播放源序號，傳給播放接口
sources[].name string 播放源名稱
sources[].episodes array 該源的選集列表
sources[].episodes[].nid string 集數序號，傳給播放接口
sources[].episodes[].name string 集數名稱
sources[].episodes[].url string 播放頁地址
返回示例 
{
  "id": "812640",
  "name": "示例影片",
  "cover": "https://img.example.com/812640.jpg",
  "intro": "",
  "info": {"导演": "张三", "主演": "李四", "上映": "2026"},
  "sources": [
    {"sid": "3", "name": "线路1", "episodes": [
      {"nid": "1", "name": "第1集", "url": "https://5dy4.vip/vodplay/812640-3-1.html"}
    ]}
  ]
}
GET /api/movies/movie_555/play 累計調用 0 次

播放地址

獲取指定播放源/集數的 m3u8 播放地址。

必填：播放源序號，取自詳情接口 sources[].sid。

必填：集數序號，取自選集 episodes[].nid（電影通常為 1）。

  • 返回 data.m3u8 為可播放地址；該地址帶時效，已做較短緩存（默認 30 分鐘）。
  • 源站地址直出，不做代理轉發。
  • sid / nid 越界或源站無有效地址時返回 40001。
  • 頁面下方提供在線播放器：請求成功後自動加載播放，也可粘貼任意 m3u8 地址測試。
響應說明 外層統一格式
字段 類型 說明
id string 影片 ID（回帶入參）
sid int 播放源序號（回帶入參）
nid int 集數序號（回帶入參）
name string 片名
episode string 集數名稱
m3u8 string m3u8 播放地址（帶時效）
from string 源站標識
encrypt int 是否加密（源站字段，通常 0）
返回示例 
{
  "id": "812640",
  "sid": 3,
  "nid": 1,
  "name": "示例影片",
  "episode": "第1集",
  "m3u8": "https://cdn.example.com/812640/1000.m3u8",
  "from": "dyttm3u8",
  "encrypt": 0
}
在線播放測試 hls.js / mp4 發送上方請求成功後自動加載播放；也可直接粘貼任意播放地址（m3u8 / mp4）測試。
小影API · 通用 API 聚合服務