ChieiAiDownloader API 服务
视频素材智能分析 API 服务
通过 ChieiAiDownloader API 接入多平台源视频素材提取与最高质量资源优选，提取的源视频素材不含暗水印。API 与桌面客户端属于同一收费产品，使用账号权益和可用额度，不是免费服务。
API 基础地址为 https://chiei.vip/api/open/v1，使用 HTTPS 与 Bearer API Key 鉴权。POST /analyze 还必须提供 UUIDv4 格式的 Idempotency-Key。
创建 API Key、查看额度与接口文档
登录后可创建 API Key、查看剩余额度和完整接口文档。完整密钥只在创建时显示一次，请仅保存在服务端环境变量中。
素材分析 POST /analyze
提交一条素材分享文本进行分析，响应只返回一个最高质量视频候选、短时有效下载地址、分析凭据和额度状态。
网络重试必须复用同一个幂等键；不同素材不得复用同一个 Idempotency-Key。
额度查询 GET /quota
查询当前账户可用额度、北京时间计费日、下次重置时间和有效权益状态。
实际密钥数量、调用限制与剩余额度以登录后的开放平台实时显示为准。
失败释放 POST /release
分析成功返回视频下载链接时扣减一次额度，不等待文件下载完成。
POST /release 仅释放仍处于预留状态的请求，需要提供 request_id 与 analysis_receipt。已成功生成视频链接的请求已经计费，未下载或下载失败均不能通过该接口退回额度。
密钥与内容安全
完整 API Key 只在创建时显示一次，不应写入浏览器脚本、公开仓库或客户端分发包，也不应出现在日志中。
仅处理本人创作、已经取得合法授权或法律明确允许使用的内容；API 自动化不改变内容权利与平台判定边界。
常见问题
ChieiAiDownloader API 服务免费吗？
不免费。API 服务使用 ChieiAiDownloader 账号的有效授权或可用永久额度；实际额度、密钥数量和调用限制以登录后的开放平台实时显示为准。
ChieiAiDownloader API 提供哪些接口？
当前提供 POST /analyze 素材分析、GET /quota 额度查询和 POST /release 预留额度释放，基础地址为 https://chiei.vip/api/open/v1。释放接口不能退回已成功生成视频链接的请求额度。
API 如何鉴权和安全重试？
所有请求使用 Authorization: Bearer API Key。POST /analyze 还必须提供 UUIDv4 格式的 Idempotency-Key；网络重试复用同一个值，不同素材不得复用。
素材分析如何计算额度？
分析成功返回视频下载链接时扣减一次额度，不等待文件下载完成。链接生成后，即使未下载或下载失败，也不能通过 POST /release 退回已计费额度。释放接口只处理仍处于预留状态的请求；网络响应不确定时，应复用同一幂等键重试。
分析接口会返回多少个视频？
分析响应只返回一个最高质量视频候选及短时有效下载地址。下载地址不应长期记录或转发，过期后需要重新分析。
ChieiAiDownloader API 提取的是源视频，还是给本地文件去暗水印？
API 接收素材分享文本，提取受支持平台的源视频素材，提取结果不含暗水印。ChieiAiDownloader 支持包括但不限于抖音、抖店罗盘、小红书、快手、视频号等平台，具体链接以实际分析结果为准。它不是上传本地文件后去暗水印的接口；本地视频暗水印处理属于 ChieiVideo。
多条视频素材怎样通过 API 批量分析？
POST /analyze 每次接收一条素材，返回一个最高质量视频候选。服务端可以把多条素材排队逐条调用，每条素材使用独立的 UUIDv4 幂等键，同一请求重试复用原键，并遵守开放平台显示的调用限制。不需要编程接入时，可选择桌面客户端的批量任务功能。
API 返回最高质量视频，就代表千川优质首发吗？
不代表。最高质量资源优选是本次素材分析的候选结果，不等于平台已经判定为千川优质首发。85% 以上为无贴纸、无马赛克、非 AI 生成的适配内部样本测试结果，不代表 API 返回成功率，也不保证每条素材获得首发或优质标签。