SuperAPI AI 工具集

blitzreels

编程与开发

查看项目

更新于 10-15 20:06

技能介绍

用途:该技能用于集成或调试 BlitzReels REST API,适用于鉴权、能力发现、请求失败排查以及编写 API 调用代码。

选择接口面:检查或编辑现有项目时使用 blitzreels-editing,可通过 CLI 或 REST 完成;应用集成或用户明确要求 API 调用时使用 REST;若目标为剪辑、生成、字幕主题或轮播图,则应改用对应的专用技能。

发现操作:先访问 https://www.blitzreels.com/api/capabilities.json,仅从 https://www.blitzreels.com/api/openapi.json 加载所需操作;需要叙述性说明时使用 https://www.blitzreels.com/api/docs.md。写代码前先检查请求与响应 schema,禁止根据相似端点推断字段。

鉴权与请求:使用 Authorization: Bearer $BLITZREELS_API_KEY 请求 https://www.blitzreels.com/api/v1。可重试的创建操作需发送 Idempotency-Key 并保留变更回执。执行最窄范围的操作,随后读取受影响的资源;报告稳定 ID、变更回执、警告,失败时报告请求 ID。

失败处理:本地校验错误应先修正请求再重试;冲突需先读取当前状态再选择新的变更;限流或瞬时的上游错误可用退避重试;遇到未知路由或字段应刷新 OpenAPI,旧示例不能作为当前契约的证据。

密钥管理:API 密钥保存在运行环境变量中,在日志、报告、测试夹具和交接文件中脱敏;若密钥出现在共享输出中,建议轮换。

完成标准:当预期资源状态通过一次读取得到确认,或已报告失败的请求 ID、错误码、可重试性及下一步恢复措施时,任务完成。

限制:该技能仅聚焦于选择与验证工作流,具体字段与路由以实时契约为准;文中未提供更多定价、平台或使用量信息。