展开本页目录
开始前准备什么
- 本题公开输入为原创或虚构教学材料，不需要登录第三方平台。
- API步骤需要自己的apizt Key；在模型广场核对当前权限和费用，Key只留在本机。
- 本地处理步骤需要文中注明的Python、FFmpeg或对应工具；本地执行与云API计费分别判断。
- 启动本地MCP服务器
- 查看工具并只提交一次
- 查询并下载成功结果
- 核对可恢复行为
2026-10-24 核验材料；实际执行范围、结果与限制见下方记录。
补充：原有练习资料与下载
包含任务请求、原始模型结果、检查记录和复跑脚本。
真实操作、成品与核验记录
用自建stdio MCP把apizt视频创建、查询和下载暴露为三个工具，实际完成原创纸船视频。重复request_key复用同一task_id，换输入复用键被拒绝，下载只允许已记录成功任务的公开结果URL。
· 按下列具体任务验收API或本地执行；产品原生功能、文件成功与内容质检分别说明。
- 运行环境
- apizt API；具体型号与参数见每个请求回执；macOS；公开报告不包含凭据
1. 启动本地MCP服务器
使用下载的tokenba-video-mcp.py；Key从环境指定的私有文件读取，state目录保持私有。
2. 查看工具并只提交一次
真实JSON-RPC执行initialize和tools/list，再调用create_video；同键同输入返回reused=true。
3. 查询并下载成功结果
read_task轮询同一task_id；download_result只接受已记录任务键，校验HTTPS与公开地址，不接收任意下载URL。
4. 核对可恢复行为
重复提交不新建任务；同键换prompt报冲突；最终MP4、字节、SHA和完整无Key协议记录可下载。
这次实际得到什么
- stdio MCP实际返回三个工具，真实创建任务、重复复用、冲突拒绝及下载均完成。
使用这份结果时注意
- 自建MCP符合本例协议范围，不是Higgsfield官方MCP，也没有验证Claude客户端图形界面的安装。
这篇解决什么问题
本例去重保护位于单进程本地任务账本，不能冒称网关具备服务端幂等。提交前先写unknown；只有拿到task_id后才转accepted。多个进程不要共用该教学状态目录，未知结果先在控制台对账。
- 自建MCP符合本例协议范围，不是Higgsfield官方MCP，也没有验证Claude客户端图形界面的安装。
按实测步骤复跑
- 启动本地MCP服务器：使用下载的tokenba-video-mcp.py；Key从环境指定的私有文件读取，state目录保持私有。
- 查看工具并只提交一次：真实JSON-RPC执行initialize和tools/list，再调用create_video；同键同输入返回reused=true。
- 查询并下载成功结果：read_task轮询同一task_id；download_result只接受已记录任务键，校验HTTPS与公开地址，不接收任意下载URL。
- 核对可恢复行为：重复提交不新建任务；同键换prompt报冲突；最终MP4、字节、SHA和完整无Key协议记录可下载。
核对实际输出与失败条件
- stdio MCP实际返回三个工具，真实创建任务、重复复用、冲突拒绝及下载均完成。
来自本题实际视频帧或回写报告；不是产品官方界面。
下载输入、结果与可恢复脚本
公开包包含原始请求、输入哈希、实际输出和回执。先使用一份小样，已知异步任务只按同一task_id查询；超时且未知是否创建时，先在控制台对账。MCP示例通过环境指定私有凭据文件，普通API脚本读取tokenba_API_KEY，均不会把Key写进公开JSON。
怎样确认已经完成
- stdio MCP实际返回三个工具，真实创建任务、重复复用、冲突拒绝及下载均完成。
- 自建MCP符合本例协议范围，不是Higgsfield官方MCP，也没有验证Claude客户端图形界面的安装。
常见问题
Higgsfield MCP替代这次真实做到了什么？
用自建stdio MCP把apizt视频创建、查询和下载暴露为三个工具，实际完成原创纸船视频。重复request_key复用同一task_id，换输入复用键被拒绝，下载只允许已记录成功任务的公开结果URL。
是否需要登录第三方平台？
本页主流程按上方实测中的apizt API或本地工具执行。自建MCP符合本例协议范围，不是Higgsfield官方MCP，也没有验证Claude客户端图形界面的安装。