Imagifly logoImagifly开发者文档
Agent

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 再查询,不要重新提交。失败的任务会自动退回积分。

也可以走 HTTP API,或把同一套能力接到 MCP。

本页内容