用途:通过客户已连接的 OnlyFans 账户,下载其指定或已授权的视频等媒体;可保存单个片段、vault 媒体,或按范围创建整个 vault 的媒体归档。
主要能力与用法:认证请求使用 https://app.onlyfansapi.com,需配置 ONLYFANSAPI_API_KEY 或等价密钥,且不得将密钥写入输出或文件。先用 List Accounts 将 {account} 解析为 OFAPI 的 acct_… ID,再通过 vault、post 或 message 端点取得媒体项及其下载字段。单一签名 OnlyFans CDN URL 使用 GET /api/{account}/media/download/{cdnUrl},保留完整签名查询串;签名 URL 会过期,过期后应重新解析而非反复重试旧 URL。vault 媒体若 files.full.url 为 null 且存在 files.drm 块,使用数字 vault 媒体 ID 调用 GET /api/{account}/media/download/drm/{media_id}。下载应先写入临时 .part 文件,校验最终 HTTP 状态与内容类型后再转正,使用含稳定媒体 ID 的净化文件名,避免覆盖已有文件;JSON/HTML 错误保存成 .mp4 不算成功。多文件时用适度并发与有界重试,遵守 Retry-After 和共享速率限制,保留已完成文件并报告部分结果。
整个 vault 归档:使用 Data Exports,读取当前 create/start/status 合约,type 为 media_vault、file_type 为 zip,指定 account_ids 及所需 media/date 选项;仅视频时 options.mediaType 设为 video。准备与执行分离,若费用未授权,先以 auto_start: false 准备并查看估算,获授权后再启动;用返回的 export ID 有界轮询状态,完成后下载返回 URL 并校验 ZIP。
限制与注意:下载后若重定向,切勿把 API bearer token 转发到其他主机,curl 仅用 --location,不用 --location-trusted;返回的签名 cdn.fansapi.com 下载 URL 可直接获取而无需 API key。不得为失败下载寻求无关凭证、购买订阅或更改账户权限。加载聊天历史可能将对话标记为已读。MCP 为可选,需先确认客户端支持并征得同意,不得自动安装。二进制文件保存可能仍需 HTTP 客户端或受支持的下载工具。资料未提供具体收费、价格与平台兼容性细节。