Skill: giggle-video（接口定义）#

接口层：定义触发条件、输入参数、执行阶段、输出规范和错误策略，与具体视频生成服务无关。 各平台的 API 端点和认证方式见 impl/ 目录：

• impl/giggle.md — giggle.pro 实现

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

概述#

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

触发条件#

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

输入参数#

参数类型必填说明promptstring是视频描述/提示词platformstring否目标平台 id（见 impl/ 目录），默认 gigglestylestring否视觉风格（cinematic / anime / realistic 等）durationnumber否目标时长（秒），默认 15aspect_ratiostring否画面比例，默认 16:9resolutionstring否分辨率，默认 1080p

执行阶段#

text

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

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

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

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

输出#

json

{
  "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

错误处理策略#

错误类型处理方式限流（429）等待 60s 后重试，最多 3 次参数错误（400）提示用户修改 prompt 或参数服务故障（5xx）记录错误，通知用户稍后重试轮询超时保存 task_id，告知用户可稍后查询进度

安全约束#

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