Skill: giggle-video（接口定义）

> 接口层：定义触发条件、输入参数、执行阶段、输出规范和错误策略，与具体视频生成服务无关。

> 各平台的 API 端点和认证方式见 impl/ 目录：

>

> - impl/giggle.md — giggle.pro 实现

>

> 接入其他视频生成平台时，只需添加对应 impl/{platform}.md，本文件无需修改。

概述

调用 AI 视频生成服务，创建和追踪视频生成任务。

触发条件

• 用户请求生成视频
• 用户提供脚本/创意并要求制作
• 用户查询已提交的视频生成进度

输入参数

执行阶段

阶段 1 — 参数确认
  收集并验证所有输入参数，缺失项使用默认值。
  单次调用费用超过 $5 时，向用户告知预估费用并获取确认。

阶段 2 — 提交任务
  根据 platform 参数加载 impl/{platform}.md。
  调用实现层提交生成任务，获取 task_id。

阶段 3 — 进度追踪
  轮询任务状态，默认间隔 10s，超时上限 600s。
  超时后记录 task_id，告知用户可稍后查询。

阶段 4 — 结果处理
  成功：提取视频 URL，保存元数据。
  失败：记录错误码，建议用户调整参数。

输出

{
  "taskId": "platform_task_id",
  "platform": "giggle",
  "status": "completed | failed | timeout",
  "videoUrl": "https://...",
  "metadata": {
    "prompt": "...",
    "style": "cinematic",
    "duration": 15,
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "generationSeconds": 120
  }
}

存档路径：shared/outputs/director/{date}_{project}_video.json

错误处理策略

安全约束

• 只访问 impl/ 中定义的白名单域名
• 调用前确认用户意图
• 所有 API 调用由网关记录到审计日志