视频生成

视频有两条路：直接生成一段短片（默认可用），和启用 Movie 插件做完整叙事影片（需勾选）。两者最终都调用同一个 video 工具产出画面，区别在于 Movie 多了一层编排和时间线。

`video` 工具的三个 action

video 属于 profy-creative（user_selectable: false），任何对话都可用。

action	用途	是否消耗积分
`generate`	文生视频 / 图生视频，产出一段视频	是
`generate_batch`	并发生成多段视频（最大并发 20）	是，逐条计费
`read`	理解已有视频，返回文字描述	走多模态模型的 token 计费

generate 的参数

参数	类型	默认值	说明
`prompt`	string	`""`	画面描述
`resolution`	string	`"720p"`	分辨率，需为当前模型支持的档位
`duration`	float	`5.0`	时长（秒）
`reference_image_url`	string	`""`	首帧参考图，给了就是图生视频

默认时长是 5 秒。不说时长就只有 5 秒——想要更长必须明说「做一段 10 秒的」。

参数会被模型能力预校验

每个视频模型在后台声明了自己支持哪些参数档位。你要的分辨率或时长不在该模型的允许集合里时，工具不会去调供应商然后失败，而是直接返回 param_unsupported：

The requested resolution '4k' is not supported by the current video model.
Supported values: 480p, 720p, 1080p.
Please ask the user which value they'd like to use, or suggest the closest supported option.

专家收到这条会回来问你选哪个档位，而不是自作主张。这是好事——不校验的话你会等满一轮再拿到一个供应商侧的模糊报错。另外，如果模型配置里给某个参数设了 default，那个默认值会覆盖你和专家商定的值。要求 1080p 却拿到 720p 时，先看模型配置。

直接生成

在对话里描述画面即可：

生成一段 10 秒的日落海滩延时摄影，镜头缓慢横移，暖色调，1080p。

图生视频，把参考图发给专家再说：

把这张照片做成缓慢推进的动态视频，5 秒，人物保持不动，只有云在飘。

描述画面时把运动方向（推进 / 横移 / 旋转 / 静止）和速度（缓慢 / 快速）说清楚，比堆形容词管用——这两项是视频区别于图片的核心变量。

视频理解（read）

read 走的是平台配置的多模态模型，不是视频生成模型：

帮我看看这个视频里讲了什么，重点提取里面出现的数据。

约束：单次分析最多返回 2048 tokens 的描述，HTTP 超时 120 秒。后台没配默认多模态模型时返回：

No multimodal model configured. Please set a default multimodal model in the admin panel.

生成过程中发生了什么

和音乐生成共用同一条异步管线：

环节	数值
单次生成总等待预算	600 秒（10 分钟）
进度轮询间隔	3 秒
进度条算法	`1 - e^(-t/60)`，上限停在 95%（估算值）
供应商失败自动重试	最多 3 次尝试
只重试快失败	耗时 ≥ 60 秒的失败不重试
`generate_batch` 并发上限	20

等待期间可以让它转后台（桌面端不支持，本机没有 Redis 频道）。

Movie：七阶段编排

Movie 是 user_selectable: true 且 exclusive: true 的插件——需要在插件设置里勾选，勾选后它会独占对话，其它可选插件不会同时激活。

movie 工具本身不调用任何外部 API，它只输出结构化数据驱动前端渲染。真正产出画面的仍然是 video 工具。七个 action 对应七个阶段：

阶段	action	产出
1. 需求梳理	`brief`	主题、受众、时长、风格的结构化摘要
2. 剧本	`script`	叙事结构与对白
3. 分镜	`storyboard`	镜头列表，同时发出 `video_storyboard_init` 事件驱动面板
4. 视觉策略	`strategy`	风格、色调、一致性约束
5. 组装	`assemble`	片段按分镜顺序排布
6. 字幕	`caption`	ASR 生成的字幕数据
7. 导出	`export`	导出规格信封（不做实际编码）

分镜阶段会给每个 element / segment / shot / audio 分配稳定 ID（sb- / el- / seg- / shot- 前缀），后续的时间线操作靠这些 ID 定位。

时间线编辑

timeline_edit 工具让专家按指令改时间线，10 个 action：

action	必填参数
`insert_clip`	trackId, clipId, startTime, duration, mediaUrl, type
`remove_clip`	trackId, clipId
`trim`	trackId, clipId, trimStart, trimEnd
`split`	trackId, clipId, splitTime
`reorder`	trackId, clipIds
`add_track`	type, name
`set_volume`	trackId, clipId, volume
`add_caption`	trackId, text, startTime, duration, style
`export`	format, quality
`get_state`	无

取值约束：片段类型 video / audio / image；轨道类型 video / audio / caption / music；导出格式 mp4 / mov；导出质量 high / medium / low。参数不合法时工具直接报错并列出合法值，不会静默取近似值。所以你可以直接说「把第 3 个镜头砍掉后半段」「背景音乐音量降到 30%」「导出 mp4 高质量」，专家会翻成对应的 timeline_edit 调用。

失败与对策

现象	原因	怎么办
`No video model selected`	模型选择器没选视频模型	选一个再重试
`param_unsupported`	分辨率/时长不在当前模型的允许集合	从报错列出的合法值里选一个
要了 1080p 却出 720p	模型配置给该参数设了 `default`，会覆盖请求值	换一个不锁该参数的模型
`This model is currently unavailable...`	供应商密钥/配置问题（原始报错含密钥字样时被替换）	换模型
`Media generation timed out after 600s`	超过总等待预算	缩短时长、降分辨率，或换模型
`No multimodal model configured`	`read` 需要的多模态模型没配	联系管理员配置
时长只有 5 秒	`duration` 默认值	明确说时长

计费

视频生成的计费单位由模型在后台的定价配置决定，工具上报的只是 hint。常见是 duration_second：ceil(产出秒数 × 每秒费率)——按产出视频的时长计费，不是按生成耗时（等 3 分钟生成 5 秒视频，收的是 5 秒的钱）。部分模型走 cost_matrix，此时分辨率、帧率、时长档位的组合决定价格，工具会把实际使用的参数一并上报用于匹配档位。

失败的生成不计费（只有非 failed 结果才上报用量）
generate_batch 逐条计费，20 条就是 20 份钱
同一次对话最多结算 100 条创作类用量事件
Movie 流程里 movie 和 timeline_edit 本身不产生媒体费用，费用来自它们编排的 video / music / image 调用

各模型费率是运营数据，以模型选择器为准；算法固定，见计费公式。

Movie 一次完整流程会产生多次视频生成调用（一个分镜一段）。开始生成前先把分镜数和每段时长确认清楚，10 个 5 秒镜头就是 10 次计费。

继续阅读

音乐创作

Movie 配乐阶段调用的同一个工具

图片生成

分镜参考图常从这里来

计费公式

duration_second 与 cost_matrix 的完整算法

插件全表

哪些插件是独占的

开始使用

核心概念

使用指南

平台与账户

深入了解

`video` 工具的三个 action

generate 的参数

参数会被模型能力预校验

直接生成

视频理解（read）

生成过程中发生了什么

Movie：七阶段编排

时间线编辑

失败与对策

计费

继续阅读

音乐创作

图片生成

计费公式

插件全表

​video 工具的三个 action

​generate 的参数

​参数会被模型能力预校验

​直接生成

​视频理解（read）

​生成过程中发生了什么

​Movie：七阶段编排

​时间线编辑

​失败与对策

​计费

​继续阅读

音乐创作

图片生成

计费公式

插件全表

`video` 工具的三个 action

generate 的参数

参数会被模型能力预校验

直接生成

视频理解（read）

生成过程中发生了什么

Movie：七阶段编排

时间线编辑

失败与对策

计费

继续阅读