Fliz REST API完整集成指南 - 人工智能视频生成平台，将文本内容转换为含配音、AI生成图像和字幕的专业视频。使用场景：与Fliz API集成（WordPress、Zapier、Make、n8n、自定义应用）；通过API构建视频生成工作流；实现视频完成通知的Webhook处理程序；开发创建、管理或翻译视频的自动化工具；排查Fliz API错误或身份验证问题；了解视频处理步骤和状态轮询。核心能力：从文本/Brief创建视频、监控视频状态、翻译、复制、语音/音乐列表、Webhook通知。
Fliz API 整合 Skill
功能概述
Fliz API 整合 Skill是一项面向实际任务的技能，主要用于将文本内容转换成 AI 程序生成的视频；{} 快引用；
核心要点
- 项目: Value.；
- Base URL.；
- Auth.；
使用与执行
Bearer Token( JWT).；Get Token.；API Docs.；Format.；JSON. 校正。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
结果检查与注意事项
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
Fliz API 集成技能
以编程方式将文本内容转换为 AI 生成的视频。
快速参考
| 项目 | 值 |
|---|---|
| 基础 URL | https://app.fliz.ai |
| 认证方式 | Bearer Token（JWT） |
| 获取 Token | https://app.fliz.ai/api-keys |
| API 文档 | https://app.fliz.ai/api-docs |
| 数据格式 | JSON |
认证
所有请求均需使用 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 测试连接——若 Token 有效，将返回 HTTP 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 字段：
| 步骤值 | 状态说明 |
|---|---|
pending → scrapping → script → image_* → speech → video_rendering |
处理中 |
complete |
✅ 已就绪 —— url 字段包含 MP4 下载地址 |
failed / failed_unrecoverable |
❌ 出错 —— 请检查 error 字段 |
user_action |
⚠️ 需人工干预（请登录 Fliz 控制台操作） |
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|squarelang（字符串）：ISO 639-1 语言代码（如 en、fr、es、de、pt 等）
可选自定义参数
| 字段 | 说明 | 默认值 |
|---|---|---|
category |
article | product | ad |
article |
script_style |
旁白叙述风格 | auto |
image_style |
画面视觉风格 | hyperrealistic |
caption_style |
字幕样式 | animated_background |
caption_position |
bottom | center |
bottom |
caption_font |
字体族名称 | poppins |
caption_color |
十六进制颜色值（如 #FFFFFF） | white |
caption_uppercase |
布尔值，是否大写显示 | false |
voice_id |
指定音色 ID | auto |
is_male_voice |
布尔值，是否启用男声 | auto |
music_id |
背景音乐 ID | auto |
music_url |
自定义背景音乐 URL | null |
music_volume |
音量（0–100） | 15 |
watermark_url |
水印图片 URL | null |
site_url |
行动号召（CTA）链接地址 | null |
site_name |
行动号召（CTA）文案 | null |
webhook_url |
回调通知 URL | null |
is_automatic |
是否启用全自动流程 | true |
video_animation_mode |
full_video | hook_only |
full_video |
image_urls |
图片 URL 数组（最多 10 张） | null |
注意：当
category设为product或ad时，image_urls为必填项，且需提供 3–10 张图片。
完整枚举值列表详见 references/enums-values.md。
Webhook 回调
配置 webhook_url 参数，即可在视频生成完成或失败时接收事件通知：
{
"event": "video.complete",
"video_id": "a1b2c3d4-...",
"step": "complete",
"url": "https://cdn.fliz.ai/videos/xxx.mp4"
}
错误处理
| HTTP 状态码 | 含义 | 建议操作 |
|---|---|---|
| 200 | 成功 | 继续后续流程 |
| 400 | 请求参数错误 | 检查请求体及查询参数 |
| 401 | 未授权 | Token 无效或已过期 |
| 404 | 资源未找到 | 视频 ID 不存在或拼写错误 |
| 429 | 请求频率超限 | 按退避策略重试 |
| 500 | 服务端内部错误 | 稍后重试 |
集成模式
轮询模式（推荐）
1. POST /api/rest/video → 获取 video_id
2. 循环调用 GET /api/rest/videos/{id}
- 若 step == "complete"：任务完成，提取 url 字段
- 若 step 包含 "failed"：发生错误，检查 error 字段
- 否则：等待 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 服务端示例
脚本工具
| 脚本 | 用途 |
|---|---|
scripts/test_connection.py |
校验 API Key 是否有效 |
scripts/create_video.py |
从本地文本文件创建视频 |
scripts/poll_status.py |
持续轮询并监控视频生成状态 |
scripts/list_resources.py |
获取音色列表与背景音乐列表 |
运行方式： 热门AI工具python scripts/
相关专题
DBeaver数据导入专题，整理Excel、CSV、SQL、TXT等常见文件的数据导入方法，涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作，帮助用户将本地文件中的数据写入数据库，并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
0
2026.11.05
DBeaver安全防护专题，围绕数据库连接安全、账号密码保护和访问权限管理展开，整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法，同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项，帮助用户提高数据库日常管理的安全性。
0
2026.11.05
本专题聚焦DBeaver数据库连接配置与管理，覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库，整理相应的连接设置方法，并提供驱动缺失、认证失败和连接异常等问题的排查方向。
0
2026.11.04
本专题围绕XORM框架的结构体映射展开，说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充，并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题梳理XORM框架的入门路径，从框架定位、依赖安装、连接数据库到跑通第一个增删改查示例，讲清Engine初始化、日志开启与项目目录规划，并对比GORM等同类ORM的差异，帮助Go开发者建立整体认知。
0
2026.11.04
本专题聚焦Docker Desktop容器端口映射与访问配置，整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况，也提供相应的检查方向，方便用户完成端口配置。
0
2026.11.03
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.7万人学习
共6课时 | 54.7万人学习
最新文章
