Skill: giggle-video（接口定义）
接口层：定义触发条件、输入参数、执行阶段、输出规范和错误策略，与具体视频生成服务无关。 各平台的 API 端点和认证方式见
impl/目录：
impl/giggle.md— giggle.pro 实现接入其他视频生成平台时，只需添加对应
impl/{platform}.md，本文件无需修改。
概述
调用 AI 视频生成服务，创建和追踪视频生成任务。
触发条件
- 用户请求生成视频
- 用户提供脚本/创意并要求制作
- 用户查询已提交的视频生成进度
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 视频描述/提示词 |
| platform | string | 否 | 目标平台 id（见 impl/ 目录），默认 giggle |
| style | string | 否 | 视觉风格（cinematic / anime / realistic 等） |
| duration | number | 否 | 目标时长（秒），默认 15 |
| aspect_ratio | string | 否 | 画面比例，默认 16:9 |
| resolution | string | 否 | 分辨率，默认 1080p |
执行阶段
阶段 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
错误处理策略
| 错误类型 | 处理方式 |
|---|---|
| 限流（429） | 等待 60s 后重试，最多 3 次 |
| 参数错误（400） | 提示用户修改 prompt 或参数 |
| 服务故障（5xx） | 记录错误，通知用户稍后重试 |
| 轮询超时 | 保存 task_id，告知用户可稍后查询进度 |
安全约束
- 只访问 impl/ 中定义的白名单域名
- 调用前确认用户意图
- 所有 API 调用由网关记录到审计日志