---
name: new-api-video
description: 使用用户的 New API 生成视频，支持本地图片、音频和视频附件、模型选择、任务续查和成片下载。用户要求文生视频、图生视频、多模态参考生成，或指定 Fast YM、Seedance、MiniMax H3、AutoDL 视频模型时使用。
---

# 视频生成

用户希望在 Codex 里生成视频时，优先使用 `new-api-video` MCP，通过 `https://new.zulanhongdan.net` 调用原有 New API Key。用户明确选择其他服务或工作流时遵循其选择。

- 查询 `video_list_models` 获取当前可用模型和限制。尊重用户指定模型；普通文生视频或图片参考未指定模型时默认 Fast YM (`vh-21af769e1f93`)、5 秒、9:16；含音频或视频参考时默认 `MiniMax-H3`。不要把 AutoDL H3 用于无图片的文生视频或参考视频任务。Bantakal `seedance-2.0` 仅支持 10/15 秒和图片。
- 对本地附件调用 `video_prepare_reference(file_path=绝对路径)`，返回 `reference_id`；图片、音频、视频均可，时长自动检测，必要时转码。对公开 HTTPS 素材指定 URL、kind；远程音视频还需提供已知时长。不要把素材字节、base64 或签名地址放入对话。
- 用同一组 `reference_ids` 调用 `video_quote`。向用户简短说明模型、时长与预估费用，然后执行其已明确要求的生成，无需重复请求确认。用户只询问方案、价格、能力时，不提交生成。
- `video_create` 只提交一次，立即保留 `task_id` 和 `submission_id`。提交超时、502 或不完整回执可能已经受理；不要自动再次 POST、换模型重试或用新任务替代查询。使用 `video_list_local_tasks` 恢复任务；已有 submission_id 只用于取回已保存的回执。不确定提交须先核查记录或明确说明未知。
- 对同一个 task_id 使用 `video_wait`（单次不超过 45 秒）或 `video_get`，通常每 10–20 秒查询，遵守限流返回的等待时间。持续到终态，过程中按实际状态给出简短进展。等待超时不代表任务失败。
- 成功后立即 `video_download`，默认保存到 `~/Downloads/NewAPI-Videos/`。上游视频可能只保留 24 小时。返回绝对文件路径，使用 `![生成的视频](/absolute/path.mp4)` 展示成片，并简述模型、时长和费用。
- `video_billing` 按原令牌的任务消费/退款记录计算当前净扣费。预估值不是实扣；返回 unknown 时如实说明，不能当作零费用。任务终态与最终结算记录可能存在短暂延迟，可再次查询。

VidHub 本地附件会在提交前上传为带签名的临时素材，24 小时到期自动清理；其他支持内嵌数据的渠道直接传文件数据。模型能力不兼容时先说明限制；用户已授权自动选型时选择兼容模型，否则澄清冲突。不要悄悄丢弃音频、视频或图片参考。

Fast YM 同时携带音频和视频参考的组合实测被上游以 400 拒绝，工具已暂时拦截该组合；完整多模态默认用已实测成功的 MiniMax-H3。其他 VidHub 模型按上游公开能力展示，未逐一付费验证。

凭据由本地运行时读取；不要读取、展示或复制密钥到聊天、代码和命令参数。不要修改原来的 SeeDance MCP。只有用户明确要求清理时，才调用本地素材清理工具；自动删除仅适用于服务端已到期的临时上传。

