Signal Media Resolver API

Resolves authorized media metadata into temporary, signed playback URLs with caching and byte-range streaming support.

原始信息汇总

数据集概述：Signal Media Resolver API

简介 Signal Media Resolver API 是一个用于电影和电视应用开发的接口，能够将授权媒体元数据解析为临时的、带签名的播放 URL，并支持缓存和字节范围流式传输。

核心功能

• 支持电影和单集电视剧的解析。
• 生成临时签名的播放 URL。
• 兼容浏览器的字节范围请求。
• 支持视频流中的定位和缓冲。
• 提供视频质量元数据。
• 检测音频编解码器，优先返回 AAC 流。
• 对重复搜索启用最长 7 天的缓存。
• 可配置的结果数量限制（1 至 20）。
• 返回结构化的 JSON 响应。

使用方法 通过向 /v1/resolve 端点发送 POST 请求进行搜索。

• 电影请求示例： json { "query": "Dune 2021", "kind": "movie", "limit": 6 }

• 电视剧集请求示例： json { "query": "Severance", "kind": "series", "season": 1, "episode": 1, "limit": 6 }

请求字段说明

字段	类型	必填/说明
query	字符串	电影或电视剧的标题，与 tmdb_id 至少提供一个。
tmdb_id	字符串	TMDB 标识符，可替代 query。
kind	字符串	可选值：movie 或 series。
season	数字	电视剧的季号（仅 series 类型时需要）。
episode	数字	电视剧的集号（仅 series 类型时需要）。
limit	数字	返回结果的最大数量，范围 1-20，默认值为 6。

响应结果 每个匹配的结果可能包含以下字段：

• name：名称
• title：标题
• url：临时签名播放链接
• file_name：文件名
• file_size：文件大小
• quality_height：视频质量高度
• audio_codec：音频编解码器

缓存机制 成功的搜索结果会被缓存最多 7 天，以加快对频繁请求标题的响应速度。

错误处理

状态码	含义
400	请求无效，缺少 query 或 tmdb_id。
429	超过速率限制，需遵循 Retry-After 响应头。
502	解析器暂时不可用，建议稍后重试。

定价方案 提供四个订阅层级：BASIC（免费）、PRO（$24.99/月）、ULTRA（$59.99/月）和 MEGA（$149.99/月）。免费计划可用于测试和开发。

责任说明 该 API 面向有权访问、处理或展示相关媒体的开发者。开发者需确保其使用符合适用的许可、版权法规及当地法律。