核心用法
Fliz API Integration Skill 是一套完整的 REST API 集成指南，用于程序化调用 Fliz AI 视频生成平台。核心能力涵盖六大模块：
1. 视频创建（Create Video）
通过 POST /api/rest/video 端点提交完整文本内容，系统将自动生成带配音、字幕、AI 图像的专业视频。关键限制：API 不提取 URL 内容，上游系统必须预处理文本。
2. 状态轮询（Status Polling）
采用推荐模式：创建后通过 GET /api/rest/videos/{id} 轮询 step 字段（pending → scrapping → script → image_* → speech → video_rendering → complete），10-30秒间隔检测完成状态。
3. Webhook 通知
支持配置 webhook_url 接收异步回调，事件包括 video.complete 与失败状态，避免长轮询资源消耗。
4. 扩展操作
- 翻译：
POST /videos/{id}/translate?new_lang=fr - 复制：
POST /videos/{id}/duplicate - 资源列表：
GET /voices、GET /musics
5. 深度定制
支持 20+ 可选参数，包括画面比例（16:9/9:16/方形）、视觉风格、字幕样式、自定义配音/音乐、水印、CTA 按钮等，满足品牌差异化需求。
6. 错误处理体系
覆盖 401（令牌失效）、429（速率限制）、500（服务端异常）等场景，提供标准化重试策略。
显著优点
- 官方源权威性：基于 fliz.ai 官方 API 文档，base URL、认证方式、端点设计均与生产环境一致
- 工程化完整度高：提供 Python/Node.js/cURL 多语言示例、测试脚本、Webhook 处理模板，可直接投入生产
- 异步架构设计：同时支持轮询与 Webhook 两种模式，适配不同基础设施条件
- 多语言内容生产：内置翻译端点，支持 ISO 639-1 标准语言代码，适合全球化内容运营
- 细粒度控制：从产品展示（product）到广告投放（ad）的场景化分类，支持自定义图像注入（3-10张）
潜在局限
- 内容预处理负担：API 不处理 URL 抓取，需自建内容爬取/清洗层，增加架构复杂度
- 人工干预节点：
user_action状态需登录 Fliz 仪表板手动处理，打断全自动化流程 - 状态机黑盒：视频生成各阶段（scrapping/script/image_*/speech）耗时不透明，难以预估总时长
- 速率限制未量化：文档提及 429 错误但未公开具体 QPS/TPS 阈值，需自行压测摸索
- 依赖外部服务：AI 图像生成、语音合成依赖 Fliz 内部队列，高峰期可能出现不可控延迟
适合人群
- 自动化工程师：需要为 CMS（WordPress）、工作流平台（Zapier/Make/n8n）或自研系统构建视频生成管道
- 内容运营团队：批量将文章、产品描述转换为多语言短视频，用于 TikTok/Instagram/YouTube Shorts 分发
- MarTech 开发者：构建营销工具集，实现广告素材的程序化生成与 A/B 测试变体快速产出
- SaaS 产品团队：将视频生成能力嵌入自身平台，为客户提供增值服务
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| **令牌泄露** | `FLIZ_API_KEY` 硬编码或日志泄露导致未授权调用 | 采用环境变量注入，启用密钥轮转机制 |
| **Webhook 伪造** | 未验证回调签名导致虚假完成通知 | 实施 IP 白名单 + 回调 payload 签名验证 |
| **无限轮询** | 轮询逻辑缺陷导致高频请求触发 429 或账单异常 | 设置指数退避上限，强制最大轮询次数 |
| **内容合规** | AI 生成图像/配音可能涉及版权或敏感内容 | 建立人工审核节点，配置 `is_automatic: false` |
| **供应商锁定** | 深度依赖 Fliz 特定参数与状态机，迁移成本高 | 抽象视频生成服务层，保留多供应商扩展接口 |
| **成本失控** | 视频生成失败重试或调试产生意外费用 | 实施预算告警，区分测试/生产环境令牌 |