Fliz AI Video Generator

核心用法

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 特定参数与状态机，迁移成本高 | 抽象视频生成服务层，保留多供应商扩展接口 |

| **成本失控** | 视频生成失败重试或调试产生意外费用 | 实施预算告警，区分测试/生产环境令牌 |

核心用法

Fliz AI Video Generator 是一个面向开发者和自动化工程师的 API 集成技能，旨在将文本内容程序化地转换为专业级视频。用户通过调用 Fliz 官方 REST API，可实现从文本输入到成品视频（含配音、AI 生成图像、动态字幕）的全自动流水线。

主要工作流包括：
1. 视频创建：调用 POST /api/rest/video，传入完整文本内容（description 字段）、格式比例（16:9/9:16/方形）、目标语言等参数，获取视频 ID；
2. 状态轮询：通过 GET /api/rest/videos/{id} 轮询 step 字段，跟踪从 pending → scrapping → script → image_* → speech → video_rendering 到 complete 的完整处理链；
3. 资源管理：支持视频翻译（POST /translate）、复制（POST /duplicate）、自定义语音/配乐选择；
4. Webhook 回调：配置 webhook_url 接收视频完成或失败通知，替代主动轮询。

技能提供 Python/Node.js/cURL 多语言示例，包含连接测试、视频创建、状态监控等即用脚本，降低集成门槛。

显著优点

官方原生支持：直接对接 Fliz 官方 API（app.fliz.ai），非第三方封装，功能对齐平台最新能力；端到端自动化：从文本到成品视频无需人工介入，支持批量流水线作业，适合内容农场、电商商品视频、社媒矩阵运营；高度可定制：覆盖叙事风格、视觉风格（hyperrealistic 等）、字幕样式/位置/字体、配音性别、背景音乐音量等 20+ 参数；多语言原生：内置翻译端点，可基于已有视频一键生成多语言版本，降低本地化成本；无依赖风险：仅使用 Python 标准库及 requests，无复杂依赖树，部署轻量。

潜在缺点与局限性

内容预处理责任重：API 不接受 URL 自动抓取，上游系统必须自行完成网页抓取、文本清洗，增加集成复杂度；异步处理延迟：视频生成涉及多阶段 AI 处理（脚本→图像→语音→渲染），耗时从数分钟到数十分钟不等，需设计合理的轮询策略或依赖 webhook；部分状态需人工干预：user_action 步骤要求用户登录 Fliz 后台手动处理，纯自动化流程可能中断；产品/广告类内容限制：使用 product 或 ad 类别时必须提供 3-10 张现成图片 URL，无法完全依赖 AI 生图；API 成本与配额：作为商业 AI 视频服务，大规模使用需考虑 Fliz 平台的计费与速率限制（429 错误）。

适合的目标群体

• 内容运营团队：需要批量将文章、博客、产品描述转为短视频，分发至多平台；
• 电商卖家/独立站运营：自动化生成商品展示视频，提升转化率；
• 开发者/自动化工程师：构建 Zapier/n8n/Make 等无代码平台与 Fliz 的桥接，或开发内部 CMS 插件；
• 营销代理机构：为客户快速产出多语言、多版本的广告素材；
• 教育科技公司：将课程文本转化为带字幕的教学视频。

使用风险

性能风险：视频生成属于长时异步任务，需保障轮询逻辑含退避策略（backoff），避免触发 API 速率限制；依赖可用性：完全依赖 Fliz 官方服务稳定性，若平台维护或故障，集成系统需具备降级或重试机制；数据外发合规：文本内容需发送至 Fliz 云端处理，含敏感信息（PII、商业机密）的内容应经审查后再调用；Webhook 安全：示例代码中的 webhook handler 含调试端点，生产部署前必须添加身份验证、IP 白名单、移除调试路由；API 密钥管理：FLIZ_API_KEY 需通过环境变量安全注入，避免硬编码或误提交至版本控制。