PUBLIC API / v1.0
公开单视频 API
无需登录，使用与页面相同的真实任务接口。仅接受 TikTok、抖音和 Instagram 单视频。任务标识是临时访问凭据，请勿公开分享。接口不提供历史列表、私人 Cookie、管理配置或后台文件。
查看机器可读的 OpenAPI 规范 ↗1. 提交分享链接
POST /api/tasks
curl https://v.quanxinhdd.xyz/api/tasks \
-H 'Content-Type: application/json' \
-d '{"text":"https://vt.tiktok.com/ZSg8B3jET/"}'返回 HTTP 202，包含 task_id、status、status_url、platform、ttl_seconds 和 server_time。text 也可为混合分享文案，最多 4096 字符，必须只包含一个链接。
2. 轮询自己的任务
GET /api/tasks/{task_id}
建议每 1–2 秒轮询。status 为 queued、processing、completed、failed 或 cancelled。完成时返回真实标题、作者、media（分辨率、时长、字节大小、download_url、preview_url、cover_url），以及 ready_at、expires_at。时间均为 Unix 秒，剩余时间 = expires_at − server_time。没有平台数据的字段为 null 或空字符串。
3. 立即保存视频
请求返回的 media.download_url 即可流式下载；preview_url 用于视频播放，cover_url 用于预览封面。视频支持 HTTP Range。就绪后固定保留 180 秒，到期立即拒绝新请求，进行中的传输也可能终止，请提前下载。服务端每 0.5 秒清理到期文件和记录；重启不会延长到期时间。
| 接口 / 状态 | 行为 |
|---|---|
| GET /api/capacity | 总容量、占用数和可用名额，不返回任务列表 |
| DELETE /api/tasks/{task_id} | 取消并清理自己的任务，释放名额 |
| 409 / 410 | 文件尚未就绪 / 任务不存在或已过期 |
| 422 / 429 | 链接无效或不是单视频 / 全站 10 个名额已满或请求过于频繁 |
| 507 | 临时磁盘空间不足 |
队列、处理中和已完成但未到期的任务均计入 10 个名额。失败和取消立即释放名额。单文件最大 256 MiB，单任务超时 240 秒，下载并发 2。图集和多媒体帖子会整体拒绝，不会只取第一段冒充完整作品。平台登录、地区或访问限制可能使匿名下载失败。
iOS「快捷指令」调用
本页提供真实 API 调用步骤，未提供可安装的快捷指令文件。在快捷指令中接收“共享的 URL”，用“获取 URL 内容”向 /api/tasks 发起 POST，JSON 字段 text 为共享输入；读取 task_id 后，每 2 秒 GET 任务地址，直到 completed 或 failed。completed 时将域名与 media.download_url 拼接，用“获取 URL 内容”获取视频，再使用“存储到相簿”或“存储文件”。必须在 expires_at 前完成下载，失败时显示 error 字段并结束。