用途
giggle-video 是一个用于调用 AI 视频生成服务的技能接口定义。它通过统一的接口层，让用户能够向 giggle.pro 及其他视频生成平台提交视频生成任务，并追踪任务进度、获取生成的视频。该接口层与具体视频生成服务无关，各平台的 API 端点和认证方式由 impl/ 目录下的实现文件定义，例如 impl/giggle.md 对应 giggle.pro 实现。接入其他视频生成平台时，只需添加对应的 impl/{platform}.md 文件，本接口定义无需修改。
主要能力
- 根据用户提供的提示词创建视频生成任务。
- 支持指定目标平台（默认 giggle）、视觉风格（如 cinematic、anime、realistic 等）、目标时长（默认 15 秒）、画面比例（默认 16:9）和分辨率（默认 1080p）。
- 提交任务后获取 task_id，并轮询任务状态，默认轮询间隔 10 秒，超时上限 600 秒。
- 任务成功后提取视频 URL 并保存元数据；失败时记录错误码并建议用户调整参数。
- 输出结构化结果，包含 taskId、platform、status、videoUrl 和 metadata（含 prompt、style、duration、aspect_ratio、resolution、generationSeconds）。
- 结果存档路径为 shared/outputs/director/{date}_{project}_video.json。
使用方式
触发条件包括：用户请求生成视频、用户提供脚本或创意并要求制作、用户查询已提交的视频生成进度。
输入参数中，prompt 为必填，其余参数可选。执行分为四个阶段：
- 参数确认：收集并验证所有输入参数，缺失项使用默认值。单次调用费用超过 $5 时，向用户告知预估费用并获取确认。
- 提交任务：根据 platform 参数加载 impl/{platform}.md，调用实现层提交生成任务，获取 task_id。
- 进度追踪：轮询任务状态，默认间隔 10 秒，超时上限 600 秒。超时后记录 task_id，告知用户可稍后查询。
- 结果处理：成功时提取视频 URL 并保存元数据；失败时记录错误码，建议用户调整参数。
适用场景
适用于需要通过 AI 视频生成服务创建视频的场景，例如根据脚本或创意生成视频、查询已提交任务的进度等。
限制
- 只访问 impl/ 中定义的白名单域名。
- 调用前需确认用户意图。
- 所有 API 调用由网关记录到审计日志。
- 错误处理策略：限流（429）等待 60 秒后重试，最多 3 次；参数错误（400）提示用户修改 prompt 或参数；服务故障（5xx）记录错误并通知用户稍后重试；轮询超时保存 task_id，告知用户可稍后查询进度。
- 关于具体平台的收费、价格、可用性等细节，资料中暂未提供。