名称： fliz-ai-video-generator
版本： 1.0.0
作者： gregorybeyrouti
描述： |
Fliz REST API 完整集成指南——一个 AI 驱动的视频生成平台，可将文本内容转换为包含配音、AI 生成图像和字幕的专业视频。

在以下场景中使用此技能：
- 与 Fliz API 集成（WordPress、Zapier、Make、n8n、自定义应用）
- 通过 API 构建视频生成工作流
- 实现视频完成通知的 Webhook 处理器
- 开发用于创建、管理或翻译视频的自动化工具
- 排查 Fliz API 错误或身份验证问题
- 理解视频处理步骤和状态轮询

核心功能：基于文本/简报创建视频、视频状态监控、翻译、复制、语音/音乐列表、Webhook 通知。
主页： https://fliz.ai
标签： [video, ai, fliz, content-creation, automation, api]
元数据：
clawdbot:
emoji: "🎬"
primaryEnv: FLIZ_API_KEY

Fliz API 集成技能

通过编程方式将文本内容转换为 AI 生成的视频。

快速参考

身份验证

所有请求都需要 Bearer Token 认证：

curl -X GET "https://app.fliz.ai/api/rest/voices" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

调用 GET /api/rest/voices 来测试连接——如果令牌有效，将返回 200 状态码。

核心端点

1. 创建视频

POST /api/rest/video

最小请求示例：

{
  "fliz_video_create_input": {
    "name": "视频标题",
    "description": "要转换为视频的完整文本内容",
    "format": "size_16_9",
    "lang": "en"
  }
}

响应示例：

{
  "fliz_video_create": {
    "video_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
  }
}

关键提示：description 字段必须包含完整的文本内容。Fliz 不会从 URL 中提取内容——上游系统必须先获取/处理内容。

2. 获取视频状态

GET /api/rest/videos/{id}

轮询此端点以跟踪视频生成进度。检查 step 字段：

3. 列出视频

GET /api/rest/videos?limit=20&offset=0

4. 翻译视频

POST /api/rest/videos/{from_video_id}/translate?new_lang=fr

创建目标语言的新视频。

5. 复制视频

POST /api/rest/videos/{from_video_id}/duplicate

6. 列出语音/音乐

GET /api/rest/voices
GET /api/rest/musics

视频创建参数

必填字段

• name (字符串): 视频标题
• description (字符串): 完整文本内容
• format (枚举): size_16_9 | size_9_16 | square
• lang (字符串): ISO 639-1 语言代码 (en, fr, es, de, pt 等)

可选自定义项

注意：对于 product 和 ad 类别，image_urls 是必需的（3-10 张图片）。

完整的枚举值请参阅 references/enums-values.md。

Webhooks

配置 webhook_url 以在视频准备就绪或失败时接收通知：

{
  "event": "video.complete",
  "video_id": "a1b2c3d4-...",
  "step": "complete",
  "url": "https://cdn.fliz.ai/videos/xxx.mp4"
}

错误处理

集成模式

轮询模式（推荐）

1. POST /api/rest/video → 获取 video_id
2. 循环: GET /api/rest/videos/{id}
   - 如果 step == "complete": 完成，获取 url
   - 如果 step 包含 "failed": 错误
   - 否则: 等待 10-30 秒，重试

Webhook 模式

1. POST /api/rest/video 并附带 webhook_url
2. 收到 Webhook 回调时进行处理

代码示例

查看 assets/examples/ 获取开箱即用的实现：
- python_client.py - 完整的 Python 封装
- nodejs_client.js - Node.js 实现
- curl_examples.sh - cURL 命令
- webhook_handler.py - Flask Webhook 服务器

脚本

运行方式：python scripts/<脚本名>.py --api-key YOUR_KEY

常见问题

"无效的 API 响应"：请确保 JSON 结构与文档完全一致。

视频卡在处理中：检查 step 字段——某些步骤（如 user_action）需要在 Fliz 仪表板中手动干预。

没有 URL 提取功能：API 需要直接输入文本。请将内容提取功能构建到您的集成中。

参考文档

• API 参考 - 完整的端点文档
• 枚举值 - 所有有效的参数值
• 集成示例 - 开箱即用的代码