> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hexinzhandao.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 插件 - 视频创作助手

> 支持使用不同的视频大模型，通过文生视频、首尾帧图生视频，来生成高质量视频，追求专业的影视级质感。

<Columns cols={1}>
  <Card title="在扣子中收藏插件" icon="plug-circle-plus" href="https://www.coze.cn/store/plugin/7622282365678829620">
    如果您想自己动手搭建工作流，可在扣子平台中收藏此插件以备使用
  </Card>
</Columns>

## 视频生成 (video\_generation)

使用AI大模型通过"文生视频"或"图生视频"技术创作视频。

### video\_generation - 输入参数

<ParamField body="model_name" type="string" required>
  **大模型名称**，以下为可以选用的 AI 视频模型。

  | 大模型名称                    | 说明                                             |
  | :----------------------- | :--------------------------------------------- |
  | doubao-seedance-2-0      | 字节跳动 视频模型 Seedance 2.0 标准版，支持音画同出              |
  | doubao-seedance-2-0-fast | 字节跳动 视频模型 Seedance 2.0 快速版，适合快速生成预览视频，支持原生音画合一 |
  | doubao-seedance-1-5-pro  | 字节跳动 视频模型 Seedance 1.5 专业版，支持音画同出              |
  | MiniMax-Hailuo-2.3       | 海螺 视频模型 MiniMax 2.3 标准版                        |
  | MiniMax-Hailuo-2.3-Fast  | 海螺 视频模型 MiniMax 2.3 快速版，适合快速生成预览视频             |
  | kling-v3-omni            | 可灵 视频模型 Kling 3.0 Omni 更好的角色一致性，支持音画同出         |
  | kling-v2-6               | 可灵 视频模型 Kling 2.6                              |
</ParamField>

<ParamField body="prompt" type="string" required>
  **文本提示词**，输入用于指导模型生成视频的文本提示词。
</ParamField>

<ParamField body="resolution" type="string" required>
  **视频分辨率**，例如：`720p`。不同模型支持的视频分辨率不一样，请根据下表选择合适的分辨率。

  | 大模型名称                    | 支持的分辨率      |
  | :----------------------- | :---------- |
  | doubao-seedance-2-0      | 720p        |
  | doubao-seedance-2-0-fast | 720p        |
  | doubao-seedance-1-5-pro  | 720p, 1080p |
  | MiniMax-Hailuo-2.3       | 768p, 1080p |
  | MiniMax-Hailuo-2.3-Fast  | 768p, 1080p |
  | kling-v3-omni            | 720p, 1080p |
  | kling-v2-6               | 720p, 1080p |
</ParamField>

<ParamField body="duration" type="number" required>
  **视频时长**，单位 `秒`，不同模型、不同分辨率支持的视频时长不一样，请根据下表选择合适的时长。

  | 大模型名称                    | 分辨率          | 支持的视频时长 (秒)                                 |
  | :----------------------- | :----------- | :------------------------------------------ |
  | doubao-seedance-2-0      | 720p         | 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15    |
  | doubao-seedance-2-0-fast | 720p         | 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15    |
  | doubao-seedance-1-5-pro  | 720p / 1080p | 4, 5, 6, 7, 8, 9, 10, 11, 12                |
  | MiniMax-Hailuo-2.3       | 768p         | 6, 10                                       |
  | MiniMax-Hailuo-2.3       | 1080p        | 6                                           |
  | MiniMax-Hailuo-2.3-Fast  | 768p         | 6, 10                                       |
  | MiniMax-Hailuo-2.3-Fast  | 1080p        | 6                                           |
  | kling-v3-omni            | 720p / 1080p | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
  | kling-v2-6               | 720p / 1080p | 5, 10                                       |
</ParamField>

<ParamField body="aspect_ratio" type="string" required>
  **视频的宽高比**，例如：`9:16`。不同模型支持的视频宽高比不一样，请根据下表选择合适的比例。

  | 大模型名称                    | 支持的宽高比                                    |
  | :----------------------- | :---------------------------------------- |
  | doubao-seedance-2-0      | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive |
  | doubao-seedance-2-0-fast | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive |
  | doubao-seedance-1-5-pro  | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9           |
  | MiniMax-Hailuo-2.3       | auto                                      |
  | MiniMax-Hailuo-2.3-Fast  | auto                                      |
  | kling-v3-omni            | 9:16, 16:9, 1:1                           |
  | kling-v2-6               | 9:16, 16:9, 1:1                           |
</ParamField>

<ParamField body="first_frame_image" type="string">
  **首帧图**，图生视频中的起始帧图片，必须是公开可访问的链接，格式支持 `jpeg` `png` `gif` `bmp` `webp` 等。

  <Warning>
    * 不能同时使用 `首尾帧图` 与 `参考图`，所以 `first_frame_image` 和 `ref_images` 只能二选一。如果同时使用了，则优先走`首尾帧` 模式。
    * `kling` 和 `grok` 系列模型，不使用本参数，其首尾帧图都在 `ref_images` 中上传。
  </Warning>
</ParamField>

<ParamField body="last_frame_image" type="string">
  **尾帧图**，图生视频中的结束帧图片，必须是公开可访问的链接，格式支持 `jpeg` `png` `gif` `bmp` `webp` 等。

  <Warning>
    只有上传了 `首帧图` 时，`尾帧图` 才有效，否则将被忽略。
  </Warning>
</ParamField>

<ParamField body="ref_images" type="array<string>">
  **参考图列表**，用于图生视频中的参考图，必须是公开可访问的链接，格式支持 `jpeg` `png` `gif` `bmp` `webp` 等。

  <Warning>
    * `kling` 系列模型的首尾帧图和参考图都在此上传，第 1 张图为 `首帧图`，第 2 张图为 `尾帧图`，其他为参考图。其中 `kling-v2-6 (720P)` 仅支持传1张首帧图，`kling-v2-6 (1080P)` 仅支持传2张图表示首尾帧，`kling-v3-omni` 可传多图。
    * `kling-v3-omni` 模型，在 `prompt` 可中通过 \<\<\<image\_N>>> 引用对应位置的图片（N 从 1 开始），例如：让 \<\<\<image\_2>>> 中的人物举手。
    * `MiniMax-Hailuo` 系列模型，不使用 `参考图` 模式，无需传本参数。
  </Warning>
</ParamField>

<ParamField body="ref_videos" type="array<string>">
  **参考视频列表**，用于视频生视频中的参考视频，必须是公开可访问的链接，格式支持 `mp4` `mov` `avi` `wmv` 等。

  <Warning>
    * 仅 `doubao-seedance-2-0` 系列模型和 `kling-v3-omni` 模型支持本参数。
    * `doubao-seedance-2-0` 系列模型最多传 3 个参考视频，但在使用 `首尾尾帧` 参数时，参考视频不可用。参考视频中不可出现真人。
    * `kling-v3-omni` 使用本参数时，`image_urls` 只可上传首帧图，且最终视频不支持音画同出。
  </Warning>
</ParamField>

<ParamField body="wait_for_completed" type="boolean">
  **是否等待视频生成任务完成**，`true` 等待本次任务完成，直接出视频。`false` 只提交任务，不等待完成，先执行其他任务，适合批量任务并发执行，后面再使用 `wait_image_tasks_completed` 工具等待所有任务完成并获得结果，生成视频数量较多时，可大量节省任务时间。默认值 `true`。
</ParamField>

<ParamField body="hezhan_api_key" type="string" required>
  **合芯栈道 API 密钥**，用于识别和验证身份的凭证 `免费获取`。

  * **免费获取方式**：登录 [合芯栈道 - 会员中心](https://www.hexinzhandao.cn/user/home)，在 `API 密钥` 版块中查看。
  * **重要安全建议**：
    * 建议通过工作流开始节点的输入参数的形式使用，而不是直接明文写入插件工具的参数中。
    * 请防止在分享工作流调试记录或截图时无意间展示密钥信息。
  * **密钥失效处理**：若密钥存在泄露风险，请立即在会员中心进行重置，原密钥将即刻失效。
</ParamField>

### video\_generation - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="task_id" type="string">
  **任务 ID**，本次生成视频任务的唯一编码，可用于在 `wait_image_tasks_completed` 工具中查询任务状态和结果。
</ResponseField>

<ResponseField name="video_url" type="string">
  **生成视频的 URL**，可直接打开的视频链接。如果输入参数 `wait_for_completed` 为 `false` 即不等待任务完成的情况下，视频 URL 值为空，需另外使用 `wait_image_tasks_completed` 工具获得视频 URL。
</ResponseField>

<ResponseField name="duration" type="number">
  **生成视频的时长**，单位 `秒`。
</ResponseField>

## 等待任务完成 (wait\_video\_tasks\_completed)

用于等待生成视频的异步任务完成，返回最终生成的视频。

### wait\_video\_tasks\_completed - 输入参数

<ParamField body="task_ids" type="array<string>" required>
  **任务 ID 列表**，需要查询的任务 ID 列表。
</ParamField>

<ParamField body="hezhan_api_key" type="string" required>
  **合芯栈道 API 密钥**，用于识别和验证身份的凭证 `免费获取`。

  * **免费获取方式**：登录 [合芯栈道 - 会员中心](https://www.hexinzhandao.cn/user/home)，在 `API 密钥` 版块中查看。
  * **重要安全建议**：
    * 建议通过工作流开始节点的输入参数的形式使用，而不是直接明文写入插件工具的参数中。
    * 请防止在分享工作流调试记录或截图时无意间展示密钥信息。
  * **密钥失效处理**：若密钥存在泄露风险，请立即在会员中心进行重置，原密钥将即刻失效。
</ParamField>

### wait\_video\_tasks\_completed - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="video_urls" type="array<string>">
  **生成视频的 URL 列表**，可直接打开的视频链接的列表，即任务结果。
</ResponseField>

<ResponseField name="duration" type="number">
  **每个视频的时长**，单位 `秒`，同一批任务中，生成视频的时长是相等的。
</ResponseField>