ChieiAiDownloader API 服务
视频素材智能分析与最高质量资源优选 API
ChieiAiDownloader API 服务用于把素材分析、最高质量视频资源优选和下载交付接入服务端工作流。API 与桌面客户端属于同一收费产品，不是免费服务。
API 基础地址为 https://chiei.vip/api/open/v1，使用 HTTPS 与 Bearer API Key 鉴权。POST /analyze 还必须提供 UUIDv4 格式的 Idempotency-Key。
创建 API Key、查看额度与接口文档
开放平台需要登录，完整密钥只在创建时显示一次，请仅保存在服务端环境变量中。
素材分析 POST /analyze
提交一条素材分享文本进行分析，响应只返回一个最高质量视频候选、短时有效下载地址、分析凭据和额度状态。
网络重试必须复用同一个幂等键；不同素材不得复用同一个 Idempotency-Key。
额度查询 GET /quota
查询当前账户可用额度、北京时间计费日、下次重置时间和有效权益状态。
实际密钥数量、调用限制与剩余额度以登录后的开放平台实时显示为准。
失败释放 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；网络重试复用同一个值，不同素材不得复用。
素材分析如何计算额度？
素材分析会预留一次额度，首次成功下载交付后提交计费；如果在交付前失败，可携带 request_id 与 analysis_receipt 调用释放接口。
分析接口会返回多少个视频？
分析响应只返回一个最高质量视频候选及短时有效下载地址。下载地址不应长期记录或转发，过期后需要重新分析。