CLI
用终端安装 Imagifly CLI,登录后生成图片和视频。
Imagifly CLI 是一套命令行工具,和网站用同一套账号、积分和模型。装好后可以自己在终端里生成,也可以让 Cursor、Claude Code 等 Agent 替你调用。
需要 Node.js 18 或更高版本。
安装
npm install -g @imagifly/cli
imagifly --help登录
imagifly auth login --agent Cursor浏览器会打开授权页。登录 Imagifly 后点「允许」。--agent 换成你正在用的工具名,例如 Claude Code、Codex,授权页上会显示这个名字。
登录成功后,令牌保存在本机,不要发给别人。已授权的工具可以在 Skill 控制台 查看或撤销。
imagifly auth status
imagifly auth logout想确认登录是否可用,运行:
imagifly +me退出码 0 表示已经登录。
如果你更想让 Agent 帮你安装,把下面这句话发给它即可:
请阅读 https://imagifly.net/cli/setup.zh.md 文档,按照步骤为我安装并配置 Imagifly CLI。命令
| 命令 | 作用 |
|---|---|
imagifly auth login --agent <name> | 打开浏览器登录 |
imagifly auth logout | 退出登录 |
imagifly auth status | 查看当前登录状态 |
imagifly +me | 检查登录是否可用 |
imagifly credits | 查看当前积分余额 |
imagifly models image | 列出图片模型 |
imagifly models video | 列出视频模型 |
imagifly image generate --prompt "..." --model <id> | 生成图片 |
imagifly image history | 查看最近的生图记录,包含每次消耗的积分 |
imagifly image get --id gen_... | 查询图片任务。结果里的 generation.cost 是本次扣除的积分 |
imagifly video generate --prompt "..." --model <id> | 生成视频 |
imagifly video get --id vid_... | 查询视频任务 |
模型名称、价格、比例和可用时长以 models image / models video 当时列出的为准。
命令成功时,终端会打印一行 JSON。进度和帮助信息在另一路输出里,一般可以直接忽略。
生成图片
先看有哪些模型,再生成:
imagifly models image
imagifly image generate --prompt "黄昏雨天的茶馆" --model <id> --ratio 16:9 --wait --out tea.png常用参数:--quality high、--resolution-tier 1k、--steps 20、--reference file.png(可多次使用)。加上 --wait 会等到出图或失败。--out 必须和 --wait 一起用,用来把第一张图存到本地。
已经有任务 ID 时:
imagifly image get --id gen_... --out tea.png生成视频
imagifly models video
imagifly video generate --prompt "雨天茶馆里走五秒" --model <id> --duration 5s --wait --out clip.mp4--duration 必须是该模型支持的时长,例如 5s。还可以按模型使用 --variant、--fps、--size、--ratio、--first-frame、--last-frame。
失败时
| 退出码 | 含义 |
|---|---|
| 0 | 成功。查询任务时如果还在生成中,也是 0 |
| 2 | 参数不对 |
| 3 | 未登录,或登录已失效 |
| 4 | 生成失败,或等待超时 |
| 1 | 网络或其他意外错误 |
失败时 JSON 里会有 error 和 message。积分不足、内容未通过时,看 error 即可。任务提交成功后就会预扣积分;如果中途关掉终端,用同一个任务 ID 再查询,不要重新提交。失败的任务会自动退回积分。
