i2v.ai CLI
用 i2v.ai CLI 把素材上传、美元报价和生成写进脚本,将结果保存到项目。使用 Skills 指导 AI 生成素材或接入 API。
npx skills add https://i2v.ai --skill i2v-models在支持 Skills 的 Agent 中安装媒体工作流。使用随包 CLI 时,在启动 Agent 的环境中提供 I2V_API_KEY。
在终端设置 API Key,然后进入项目目录。提交前用 plan 预检模型参数,并获取当前账户的任务报价。
# 在启动 Agent 的 shell 里设置密钥
export I2V_API_KEY="YOUR_API_KEY"
node i2v-cli.mjs doc gpt-image-2
node i2v-cli.mjs plan gpt-image-2 --input '{"prompt":"A ceramic mug on an oak table"}'
# 输入你批准的预算和 plan 返回的 expectedRevision
BUDGET_USD="YOUR_APPROVED_USD_BUDGET"
REVISION="MODEL_REVISION_FROM_PLAN"
node i2v-cli.mjs run gpt-image-2 --input '{"prompt":"A ceramic mug on an oak table"}' \
--max-cost-usd "$BUDGET_USD" --expected-revision "$REVISION" --no-wait
node i2v-cli.mjs status TASK_ID --wait 120 --out ./mug.png用 --max-cost-usd 设置你接受的美元预算。拿到任务 ID 后,用 status 保存结果。任务 ID 丢失时,使用原凭据和幂等键运行 recover 查询提交回执。
curl.exe -fsSLo i2v-cli.mjs https://i2v.ai/cli/i2v-cli.mjs
$env:I2V_API_KEY = "YOUR_API_KEY"
node .\i2v-cli.mjs list --type image在支持 Streamable HTTP 的客户端填入远程地址。客户端支持 OAuth 时可直接授权,也可以在客户端将 API Key 配置为 Bearer 凭据。
客户端配置与连接测试https://i2v.ai/api/mcp如果客户端通过本地进程启动 MCP,请下载 CLI 并配置以下命令。在其环境中提供 I2V_API_KEY。设置 I2V_WORKSPACE_DIR 后可在指定项目目录内上传和下载。
node /absolute/path/i2v-cli.mjs mcp{
"mcpServers": {
"i2v": {
"command": "node",
"args": [
"/absolute/path/i2v-cli.mjs",
"mcp"
]
}
}
}可以使用 list、doc 和 price 查看公开目录。报价、余额、上传、生成和查单使用你的账户。
拿到任务 ID 就用 status 继续查询。只保留了幂等键时,用原凭据运行 recover 查原任务。
本地 stdio 可保存在指定工作目录内,远程 MCP 会返回结果 URL。
用 --max-cost-usd 控制单次任务预算,在 API Key 设置中管理累计限额。OAuth 连接按需要授予写权限。