在 Codex CLI 所在的终端运行以下命令。
codex mcp add i2v --url https://i2v.ai/api/mcp按提示在浏览器登录 i2v.ai。如果尚未授权,运行 codex mcp login i2v。
需要上传或生成时,重新授权并在 i2v.ai 同意页启用写权限。
codex mcp login i2v --scopes mcp:read,mcp:write把下面的指令发给已连接的客户端,即可查看当前图片模型目录,全程无需提交任务。
请调用 i2v.ai 的 list_models 工具,将 mediaType 设为 image。如果还有下一页,用 offset 继续获取,直到取齐 total 条结果。请显示模型总数,并列出每个模型的名称和 ID。请勿创建生成任务。
请用 i2v.ai 的 get_account 查看我的可用和预留美元余额与当前权限,再用 get_usage 查询最近 30 个 UTC 自然日。请显示这段时间的结算费用、用量退款和净消耗。
按任务类型、参考素材和输出要求筛选候选模型。
recommend_models检查实际输入,并在提交前查看当前账户的 USD 预留报价。
prepare_generation设置批准的预算上限,保留任务 ID 或原幂等键,以便断线后找回任务。
create_task · recover_submission请用 i2v.ai 规划一张蓝色陶瓷杯的棚拍商品图。展示所选模型、画幅和实际输入的美元报价。等我批准预算后,用该上限和预检返回的模型版本只提交一次。请给我任务 ID,完成后返回结果。
请把参考图作为首帧,规划一段五秒竖屏视频。用 i2v.ai 选一个兼容的模型,保持主体一致,并展示参数和美元报价。等我批准后再创建任务。
OAuth 默认只读,可选型、询价和查单。只有上传和提交任务需要写权限。API Key 可进行读操作和任务提交。
连接、浏览模型和预检报价免费。提交生成任务时可能预留美元余额。使用 maxCostUsd 限制初始预留,并传入预检返回的 expectedRevision。
可粘贴公开的 HTTPS 地址,或使用客户端支持的上传方式。本地 stdio 可以在 I2V_WORKSPACE_DIR 内上传或保存文件。远程 MCP 返回结果链接。
有任务 ID 就用 get_task 继续查询。丢失任务 ID 时,可以通过原凭据和幂等键调用 recover_submission。OAuth 提交时需要设置 recoveryScope 为 connection,后续才能找回。
远程 MCP 工具由 i2v.ai 更新。客户端缓存旧工具列表时,刷新工具或重新连接。本地 stdio 在连接时检查版本,运行 i2v-cli.mjs doctor 可查看 CLI、随包 Skill 和服务端版本。安装更新由你确认,本地 stdio 替换脚本后需要重启客户端。