飞影智能体快速接入指南

这是一份给第一次使用智能体的快速说明。无论使用 WorkBuddy 还是 Codex，完成后都能接入飞影、验证账户，并用同一模板批量生成视频。

目标：不需要研究 MCP 协议。选定你正在使用的智能体，完成 Token 设置、连接验证和模板批量制作；首次作品不需要上传人物或克隆声音。

准备 API Token

当前飞影 MCP 接入地址为 https://hifly.cc/mcp，无需手动修改。只需在智能体 → API 明细中复制你自己的 API Token。

不要把 Token 发到群聊、工单、截图、代码仓库或当前对话中。

选择接入平台

优先选择你正在使用的智能体。WorkBuddy 和 Codex 都能完成模板查询、逐条调用模板生成视频和任务状态查询；同一 Token 可用于任一平台。

在 WorkBuddy 中接入

打开专家·技能·连接器 → 连接器 → 自定义连接器。
进入配置 MCP，添加名为 hifly 的远程 streamableHttp 服务，并填入上方地址和 Authorization: Bearer <你的飞影 API Token>。
保存后点击信任，确认服务显示为已启用；然后在新任务里执行下方的验证指令。

需要逐图操作时，查看 WorkBuddy MCP 完整图文教程 →

在 Codex 中接入

如果使用 macOS 上的 Codex 桌面应用：打开“终端”，运行以下命令，输入时 Token 不会显示。完成后完全退出并重新打开 Codex，再继续下一步。

read -rs "HIFLY_API_TOKEN?粘贴飞影 API Token: "
echo
launchctl setenv HIFLY_API_TOKEN "$HIFLY_API_TOKEN"
unset HIFLY_API_TOKEN

如果使用 Codex CLI：在准备运行 Codex 的同一个终端中设置：

export HIFLY_API_TOKEN="<你的飞影 API Token>"

把接入指令交给 Codex

完成上一步并重新打开 Codex 后，把下方内容复制到新的 Codex 对话中。Codex 不应要求你把 Token 发到对话里。

如果 Codex 不能完成配置，使用下面的完整图文教程继续即可。

验证连接

在你已接入的平台中新建对话或任务，输入：

帮我确认飞影账户是否已经接通，并告诉我当前套餐和可用积分；不要创建任何作品。

能得到结果，即表示 MCP、网络与 Token 已正确连接。

用模板批量生成作品

首次建议从模板批量制作开始：不需要上传人物、克隆声音或设置复杂参数。飞影会为每条文案分别创建一个视频任务，由智能体负责按顺序或额度限制多次调用模板工具。

先让当前智能体帮你挑一个合适的模板：

帮我看看飞影里有哪些视频模板，推荐一个最适合新手做第一支作品的，并说明我需要补充什么内容。先不要生成视频。

选定模板后，把文案列表直接发给当前智能体即可。建议第一次先制作 3 条：

请使用刚才推荐的飞影模板，把下面每条文案分别制作成一支视频：
1. <第 1 条文案>
2. <第 2 条文案>
3. <第 3 条文案>

先告诉我将制作几支视频、每支使用的文案、比例和可能的消耗信息（如有；不要猜测）。等我回复“确认创建”后再开始；请逐支制作，不要重复提交。完成后按文案逐条告诉我任务结果，不要自动反复查询。

提交成功后，使用以下指令批量查看结果：

帮我查看刚才制作的飞影视频现在是否完成。仍在处理中就告诉我进度；已完成就给我对应的成片链接；失败请说明原因，但不要重新创建。

安全提醒

API Token 是访问凭证，只保存在本机环境变量或客户端的安全凭证区。
批量制作由多次单条创建组成；先查询模板，让智能体列出本次数量与参数后再明确确认创建。
涉及真人形象或声音时，只能使用你拥有合法使用权、并已获得本人授权的素材。
如 Token 刷新或替换，更新对应平台中的配置后重启客户端。