Fliz视频生成API

技能简介

Fliz REST API 是一套将文本内容自动转换为专业视频的编程接口，支持语音合成、AI图像生成与字幕叠加。开发者可通过该接口在自有系统内嵌入视频生产能力。

能做什么

• 基于文本/Brief自动生成带配音的MP4视频
• 轮询查询视频处理进度（pending → complete）
• 视频多语言翻译与副本复制
• 获取可用音色与背景音乐列表
• 配置Webhook接收完成/失败通知

使用说明

1. 安装准备

需先获取API密钥：访问 https://app.fliz.ai/api-keys 生成JWT令牌，并设置环境变量：

export FLIZ_API_KEY="your_jwt_token_here"

2. 验证连接

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

返回200即表示认证通过。

3. 创建视频

curl -X POST "https://app.fliz.ai/api/rest/video" \
  -H "Authorization: Bearer $FLIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fliz_video_create_input": {
      "name": "视频标题",
      "description": "完整正文内容（不支持URL自动抓取）",
      "format": "size_16_9",
      "lang": "zh"
    }
  }'

响应返回video_id，用于后续状态查询。

4. 状态轮询

curl -X GET "https://app.fliz.ai/api/rest/videos/{video_id}" \
  -H "Authorization: Bearer $FLIZ_API_KEY"

关注step字段：complete状态时可获取MP4下载链接。

输入与输出

见下方输入与输出表格。

风险提示

• description字段必须传入完整文本，Fliz不会自动抓取URL内容
• product/ad类视频需额外提供3-10张image_urls
• 429状态码表示触发限流，需实现指数退避重试
• webhook_url需为公网可访问地址，否则无法接收回调

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jb-fliz/fliz-ai-video-generator/SKILL.md
来源类型：GitHub Skill文档